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
|
#ifndef __TOKSTR_H
#define __TOKSTR_H
// tokstr -- textual token iterator with some input independence
// 2022-01-29 [revised during code review, add regions]
// 2022-01-25 [initially released inside dnsdbq]
/* example using heap-allocated strings:
struct tokstr *ts = tokstr_string("this:is+-test");
for (char *t; (t = tokstr_next(ts, "-:+")) != NULL; free(t))
printf("\t\"%s\"\n", t);
tokstr_last(&ts);
* will output "this", "is", and "test". so will this:
struct tokstr *ts = tokstr_string("this:is+-test");
for (char t[100]; tokstr_next_copy(ts, "-:+", t, sizeof t) > 0;)
printf("\t\"%s\"\n", t);
tokstr_last(&ts);
* as will this:
struct tokstr *ts = tokstr_string("this:is+-test");
for (;;) {
struct tokstr_reg t = tokstr_next_region(ts, "-:+");
if (t.base == NULL)
break;
printf("\t\"%*s\"\n", t.size, t.base);
}
tokstr_last(&ts);
*/
// opaque type for iterator state -- never used
struct tokstr;
struct tokstr_reg {
const char *base;
size_t size;
};
// tokstr_region -- create an iterator for a counted string
struct tokstr *tokstr_region(struct tokstr_reg);
// tokstr_string -- create an iterator for a nul-terminated string
struct tokstr *tokstr_string(const char *);
// tokstr_string -- create an iterator for a nul-terminated string
struct tokstr *tokstr_string(const char *);
// tokstr_next -- return next token from an iterator (which must be free()'d)
// (NULL means no more tokens are available.)
char *tokstr_next(struct tokstr *, const char *);
// tokstr_next_copy -- copy next token from an iterator; return size, 0, or -1
// (0 means no more tokens are available.)
ssize_t tokstr_next_copy(struct tokstr *, const char *, char *, size_t);
// tokstr_next_region -- return next token from iterator (zero-copy)
// (.base == NULL means no more tokens are available.)
// NOTE WELL: if program state becomes undefined here, can assert() or abort()
struct tokstr_reg tokstr_next_region(struct tokstr *, const char *);
// tokstr_last -- destroy an iterator and release all of its internal resources
void tokstr_last(struct tokstr **);
#endif /*__TOKSTR_H*/
|
