dat_file.h 3.89 KB
Newer Older
1
/* dat_file.h */
2

3
/* Functions to deal with comma (CSV) and tab-delimited files and lists */
4

5
/* $Id: dat_file.h,v 1.4 2018/07/24 01:13:09 rswindell Exp $ */
6 7 8 9 10

/****************************************************************************
 * @format.tab-size 4		(Plain Text/Source Code File Header)			*
 * @format.use-tabs true	(see http://www.synchro.net/ptsc_hdr.html)		*
 *																			*
11
 * Copyright Rob Swindell - http://www.synchro.net/copyright.html			*
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
 *																			*
 * This library is free software; you can redistribute it and/or			*
 * modify it under the terms of the GNU Lesser General Public License		*
 * as published by the Free Software Foundation; either version 2			*
 * of the License, or (at your option) any later version.					*
 * See the GNU Lesser General Public License for more details: lgpl.txt or	*
 * http://www.fsf.org/copyleft/lesser.html									*
 *																			*
 * Anonymous FTP access to the most recent released source is available at	*
 * ftp://vert.synchro.net, ftp://cvs.synchro.net and ftp://ftp.synchro.net	*
 *																			*
 * Anonymous CVS access to the development source and modification history	*
 * is available at cvs.synchro.net:/cvsroot/sbbs, example:					*
 * cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs login			*
 *     (just hit return, no password is necessary)							*
 * cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs checkout src		*
 *																			*
 * For Synchronet coding style and modification guidelines, see				*
 * http://www.synchro.net/source.html										*
 *																			*
 * You are encouraged to submit any modifications (preferably in Unix diff	*
 * format) via e-mail to mods@synchro.net									*
 *																			*
 * Note: If this box doesn't appear square, then you need to fix your tabs.	*
 ****************************************************************************/

38 39
#ifndef _DAT_FILE_H
#define _DAT_FILE_H
40 41 42 43 44 45 46

#include "str_list.h"

#if defined(__cplusplus)
extern "C" {
#endif

47 48 49 50
/***************/
/* Generic API */
/***************/

51 52
typedef str_list_t	(*dataLineParser_t)(const char*);
typedef char*		(*dataLineCreator_t)(const str_list_t);
53 54

/* columns arguments are optional (may be NULL) */
55
str_list_t*	dataParseList(const str_list_t records, str_list_t* columns, dataLineParser_t);
56 57
str_list_t*	dataReadFile(FILE* fp, str_list_t* columns, dataLineParser_t);

58 59 60
str_list_t	dataCreateList(const str_list_t records[], const str_list_t columns, dataLineCreator_t);
BOOL		dataWriteFile(FILE* fp, const str_list_t records[], const str_list_t columns
						  ,const char* separator, dataLineCreator_t);
61 62 63
FILE*		dataOpenFile(const char* path, const char* mode);
int			dataCloseFile(FILE*);
BOOL		dataListFree(str_list_t*);
64 65

/* CSV (comma separated value) API */
66 67
char*		csvLineCreator(const str_list_t);
str_list_t	csvLineParser(const char* line);
68 69 70 71
#define		csvParseList(list,col)			dataParseList(list,col,csvLineParser)
#define		csvCreateList(rec,col)			dataCreateList(rec,col,csvLineCreator)
#define		csvReadFile(fp,col)				dataReadFile(fp,col,csvLineParser)
#define		csvWriteFile(fp,rec,sep,col)	dataWriteFile(fp,rec,col,sep,csvLineCreator)
72 73 74
#define		cvsOpenFile(path, mode)			dataOpenFile(path, mode)
#define		csvCloseFile(fp)				dataCloseFile(fp)
#define		cvsListFree(list)				dataListFree(list)
75 76

/* Tab-delimited API */
77 78
char*		tabLineCreator(const str_list_t);
str_list_t	tabLineParser(const char* line);
79 80 81 82
#define		tabParseList(list,col)			dataParseList(list,col,tabLineParser)
#define		tabCreateList(rec,col)			dataCreateList(rec,col,tabLineCreator)
#define		tabReadFile(fp,col)				dataReadFile(fp,col,tabLineParser)
#define		tabWriteFile(fp,rec,sep,col)	dataWriteFile(fp,rec,col,sep,tabLineCreator)
83 84 85
#define		tabOpenFile(path, mode)			dataOpenFile(path, mode)
#define		tabCloseFile(fp)				dataCloseFile(fp)
#define		tabListFree(list)				dataListFree(list)
86 87 88 89 90 91

#if defined(__cplusplus)
}
#endif

#endif	/* Don't add anything after this line */