Mercurial > code
annotate buf.h @ 145:24efccba44e4
Remove tests
author | David Demelier <markand@malikania.fr> |
---|---|
date | Fri, 11 May 2012 00:37:38 +0200 |
parents | 5ed54050ae31 |
children | 2563b3e71859 |
rev | line source |
---|---|
125
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
1 /* |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
2 * buf.h -- easy way to manipulate strings |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
3 * |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
4 * Copyright (c) 2011, 2012, David Demelier <markand@malikania.fr> |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
5 * |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
7 * purpose with or without fee is hereby granted, provided that the above |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
8 * copyright notice and this permission notice appear in all copies. |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
9 * |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
17 */ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
18 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
19 #ifndef _BUF_H_ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
20 #define _BUF_H_ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
21 |
135
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
22 #include <stdarg.h> |
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
23 |
125
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
24 #ifdef __cplusplus |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
25 extern "C" { |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
26 #endif |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
27 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
28 #ifndef BUF_DEFAULT_BSIZE |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
29 #define BUF_DEFAULT_BSIZE 128 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
30 #endif |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
31 |
131
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
32 #ifdef __GNUC__ |
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
33 # define _buf_at_printf(i1, i2) __attribute__ ((format (printf, i1, i2))) |
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
34 #else |
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
35 # define _buf_at_printf(i1, i2) |
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
36 #endif |
cbfad4fb80c8
Buf: remove buf_puts and add printf format
David Demelier <markand@malikania.fr>
parents:
129
diff
changeset
|
37 |
125
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
38 enum { |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
39 BUF_AUTO = 0, /* string grows automatically */ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
40 BUF_FIXED = (1 << 0), /* fixed size string */ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
41 BUF_UNSAFE = (1 << 1), /* string may be truncated */ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
42 }; |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
43 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
44 struct buf { |
135
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
45 int flags; /* (ro) string flags */ |
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
46 char *text; /* (ro) string text */ |
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
47 size_t length; /* (ro) string length */ |
07800b7af208
Huge cosmetic, no breakage
David Demelier <markand@malikania.fr>
parents:
133
diff
changeset
|
48 size_t alsize; /* (ro) allocated size */ |
138 | 49 int bsize; /* (ro) block size (used when growing) */ |
125
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
50 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
51 /* Own allocation functions */ |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
52 void * (*malloc)(size_t); |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
53 void * (*realloc)(void *, size_t); |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
54 }; |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
55 |
133 | 56 int |
57 buf_init(struct buf *); | |
58 | |
59 void | |
60 buf_set(struct buf *, const char *, ...); | |
61 | |
62 int | |
63 buf_ncat(struct buf *, const char *, size_t); | |
64 | |
65 int | |
66 buf_cat(struct buf *, const char *); | |
67 | |
68 int | |
69 buf_putc(struct buf *, int); | |
70 | |
71 int | |
72 buf_vprintf(struct buf *, const char *, va_list); | |
73 | |
74 int | |
75 buf_printf(struct buf *, const char *, ...) _buf_at_printf(2, 3); | |
76 | |
77 int | |
78 buf_trim(struct buf *); | |
79 | |
80 void | |
141
5ed54050ae31
Added buf_cut, cut the buffer
David Demelier <markand@malikania.fr>
parents:
138
diff
changeset
|
81 buf_cut(struct buf *, int); |
5ed54050ae31
Added buf_cut, cut the buffer
David Demelier <markand@malikania.fr>
parents:
138
diff
changeset
|
82 |
5ed54050ae31
Added buf_cut, cut the buffer
David Demelier <markand@malikania.fr>
parents:
138
diff
changeset
|
83 void |
133 | 84 buf_clear(struct buf *); |
85 | |
86 void | |
87 buf_free(struct buf *); | |
88 | |
125
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
89 #ifdef __cplusplus |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
90 } |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
91 #endif |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
92 |
b9723c197038
Add brand new string buffer
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
93 #endif /* _BUF_H_ */ |