2 * Copyright (C) 2013 Cumulus Networks, Inc.
4 * This file is part of Quagga.
6 * Quagga is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2, or (at your option) any
11 * Quagga is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with Quagga; see the file COPYING. If not, write to the Free
18 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
26 * CSV encoding and decoding routines.
32 * csv_record_t *fstrec;
36 * csv = csv_init(csv, buf, BUFSIZ);
38 * fstrec = csv_encode(csv, 2, "hello", "world");
39 * rec = csv_encode(csv, 2, "foo", "bar");
41 * fstrec = csv_encode_record(csv, fstrec, 2, "HELLO", "WORLD");
52 * csv = csv_init(csv, rcvdbuf, BUFSIZ);
57 * for (rec = csv_record_iter(csv); rec;
58 * rec = csv_record_iter_next(rec)) {
60 * for (str = csv_field_iter(rec, &fld); str;
61 * str = csv_field_iter_next(&fld)) {
72 #include <sys/queue.h>
74 typedef struct _csv_field_t_ csv_field_t
;
75 typedef struct _csv_record_t_ csv_record_t
;
76 typedef struct _csv_t_ csv_t
;
79 * Initialize the CSV structure (if necessary, allocate first). Point to
80 * the passed string buffer.
82 csv_t
* csv_init(csv_t
*csv
, char *buf
, int buflen
);
85 * Encode the variable list of arguments as CSV fields. The csv structure
86 * should have been initialized (with the string buffer). The fields get
87 * concatenated into the string.
89 csv_record_t
*csv_encode(csv_t
*csv
, int count
, ...);
92 * Encode the variable list arguments into an existing record, essentially
93 * overwriting the record. No checking is done for consistency. The number
94 * of fields should be the same as what was encoded and the length of each
95 * field should also be the same as what was encoded before. The "rec"
96 * parameter should be the same as what was returned from a previous call
99 * Useful for message encoding/decoding that get passed around between
100 * processes/nodes - e.g. the message header record can be rewritten AFTER
101 * encoding all other records, with new information such as total length.
103 csv_record_t
*csv_encode_record(csv_t
*csv
, csv_record_t
*rec
,
107 * Decode a CSV formatted string. The csv structure should have been
108 * initialized (with the string). The function creates a LIST of records
109 * (csv_record_t structure) where each record is in turn a LIST of fields
110 * (csv_field_t structure). The record points to the string containing the
111 * list of fields. Similarly, the field points to the field string.
112 * NB: csv initialized for discrete buf , caller will pass inbuf
114 void csv_decode(csv_t
*csv
, char *inbuf
);
117 * Dump all fields of a decoded CSV to stderr
119 void csv_dump(csv_t
*csv
);
122 * Total length of all characters encoded in the CSV.
124 int csvlen(csv_t
*csv
);
126 void csv_clean(csv_t
*csv
);
127 void csv_free(csv_t
*csv
);
130 * Iterate through the records and fields of an encoded/decoded CSV.
132 csv_record_t
*csv_record_iter(csv_t
*csv
);
133 csv_record_t
*csv_record_iter_next(csv_record_t
*rec
);
134 char *csv_field_iter(csv_record_t
*rec
, csv_field_t
**fld
);
135 char *csv_field_iter_next(csv_field_t
**fld
);
138 * Return the length of field
140 int csv_field_len(csv_field_t
*fld
);
143 * Checks to see if a record belongs to a csv
145 int csv_is_record_valid(csv_t
*csv
, csv_record_t
*in_rec
);
148 * concat two records in a csv
149 * Returns the newly formed record which includes fields from rec1 and rec2
150 * rec1 and rec2 are removed
152 csv_record_t
*csv_concat_record(csv_t
*csv
, csv_record_t
*rec1
,
156 * Remove a record from csv
157 * Only works when csv has discrete record bufs
159 void csv_remove_record(csv_t
*csv
, csv_record_t
*rec
);
162 * Insert a record into csv
163 * Only works when csv has discrete record bufs
165 void csv_insert_record(csv_t
*csv
, csv_record_t
*rec
);
168 * append fields to a record
169 * Only works when csv has discrete record bufs
172 csv_append_record (csv_t
*csv
, csv_record_t
*rec
, int count
, ...);
175 * Serialize contents of csv into string
176 * Only works when csv has discrete record bufs
178 int csv_serialize(csv_t
*csv
, char *msgbuf
, int msglen
);
182 * Only works when csv has discrete record bufs
184 void csv_clone_record (csv_t
*csv
, csv_record_t
*in_rec
, csv_record_t
**out_rec
);
187 * Return number of records
189 int csv_num_records (csv_t
*csv
);