aboutsummaryrefslogtreecommitdiff
path: root/csv.h
blob: 11cc5096283516c930c7c3ffe741af0102bf3938 (plain)
1
2
3
4
5
6
7
8
9
10
11
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
#pragma once

#include <stddef.h> /* size_t */
#include <stdio.h>  /* FILE */

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
	CSV_ERR_OK            = 0,
	CSV_ERR_OUT_OF_MEMORY = -1,
	CSV_ERR_OUT_OF_RANGE  = -2,
	CSV_ERR_IO_READ       = -3,
	CSV_ERR_IO_WRITE      = -4
} csv_err_t;

typedef struct {
	int field_delimiter;
	int field_separator;

	void (*cb_error)(csv_err_t, void *);
	void *cb_error_arg;

	void *(*cb_allocate)(size_t, size_t, void *);
	void *(*cb_reallocate)(void *, size_t, size_t, void *);
	void (*cb_free)(void *, size_t, size_t, void *);
	void *cb_memory_arg;
} csv_options_t;

extern const csv_options_t csv_default_options;

typedef struct {
	char * str;
	size_t cap, pos;
} csv_string_t;

typedef struct {
	size_t *fields;
	size_t  cap, pos;
} csv_field_t;

typedef struct {
	const csv_options_t *csv_options;
	csv_string_t         csv_string;
	csv_field_t          csv_field;
} csv_t;

/* version */
extern const char csv_version[];

/* initialization */
void csv_init(csv_t *csv);
void csv_init_opt(csv_t *csv, const csv_options_t *const csv_options);

/* cleanup after error */
void csv_cleanup(csv_t *csv);

/* read */
int csv_read(csv_t *csv, FILE *in);

/* field access */
size_t      csv_nfields(const csv_t *const csv);
const char *csv_field(const csv_t *const csv, size_t idx);

/* error handling */
const char *csv_err_str(csv_err_t csv_err);

#ifdef __cplusplus
}
#endif