Mercurial > code
annotate buffer.h @ 66:f773c76b1f3c
Added extern C tests
author | David Demelier <markand@malikania.fr> |
---|---|
date | Wed, 09 Nov 2011 21:08:43 +0100 |
parents | cda80ba48029 |
children | 580d76781c9e |
rev | line source |
---|---|
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
1 /* |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
2 * buffer.h -- safe unlimited size string |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
3 * |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
4 * Copyright (c) 2011, David Demelier <markand@malikania.fr> |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
5 * |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
7 * purpose with or without fee is hereby granted, provided that the above |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
8 * copyright notice and this permission notice appear in all copies. |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
9 * |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
17 */ |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
18 |
2
86c845f86868
Switch to more internal define
David Demelier <markand@malikania.fr>
parents:
1
diff
changeset
|
19 #ifndef _BUFFER_H_ |
86c845f86868
Switch to more internal define
David Demelier <markand@malikania.fr>
parents:
1
diff
changeset
|
20 #define _BUFFER_H_ |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
21 |
66 | 22 #include <stdarg.h> |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
23 |
66 | 24 #ifdef __cplusplus |
25 extern "C" { | |
26 #endif | |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
27 |
55
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
28 /* |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
29 * Some useful attributes with gcc or clang. |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
30 */ |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
31 |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
32 #if defined(__GNUC__) |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
33 # pragma GCC diagnostic warning "-Wnonnull" |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
34 # pragma GCC diagnostic warning "-Wformat" |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
35 # define __at_malloc __attribute__ ((malloc)) |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
36 # define __at_nonnull __attribute__ ((nonnull(1))) |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
37 # define __at_printf(...) __attribute__ ((format(printf, __VA_ARGS__))) |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
38 #else |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
39 # define __at_malloc |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
40 # define __at_nonnull |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
41 # define __at_printf(...) |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
42 #endif |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
43 |
66 | 44 #define BUFFER_DEFAULT_BSIZE 512 |
45 | |
47 | 46 enum buffer_type { |
47 BUFFER_FIXED = 0, | |
48 BUFFER_AUTO = 1 | |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
49 }; |
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
50 |
47 | 51 struct buffer { |
52 enum buffer_type type; /* buffer type (default AUTO) */ | |
53
bbe0713e8e2a
Rename member to text, more useful
David Demelier <markand@malikania.fr>
parents:
47
diff
changeset
|
53 char *text; /* string buffer */ |
47 | 54 size_t length; /* string's real length */ |
55 size_t size; /* current allocated size */ | |
56 int bsize; /* initial length */ | |
57 }; | |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
58 |
55
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
59 struct buffer *buffer_new(enum buffer_type, int) __at_malloc; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
60 int buffer_strcat(struct buffer *, const char *) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
61 int buffer_putc(struct buffer *buf, char) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
62 int buffer_bcat(struct buffer *, const void *, size_t) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
63 int buffer_vprintf(struct buffer *, const char *, va_list) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
64 int buffer_printf(struct buffer *, const char *, ...) __at_printf(2, 3); |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
65 int buffer_shrink(struct buffer *) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
66 char *buffer_end(struct buffer *) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
67 void buffer_clear(struct buffer *) __at_nonnull; |
cda80ba48029
Add beautiful gcc attribute to buffer
David Demelier <markand@malikania.fr>
parents:
53
diff
changeset
|
68 void buffer_free(struct buffer *) __at_nonnull; |
0
a20beb164de8
Added buffer.c and buffer.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
69 |
66 | 70 #ifdef __cplusplus |
71 } | |
72 #endif | |
73 | |
2
86c845f86868
Switch to more internal define
David Demelier <markand@malikania.fr>
parents:
1
diff
changeset
|
74 #endif /* _BUFFER_H_ */ |