]>
Commit | Line | Data |
---|---|---|
064af421 | 1 | /* |
48718554 | 2 | * Copyright (c) 2008, 2009 Nicira Networks. |
064af421 | 3 | * |
a14bc59f BP |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at: | |
064af421 | 7 | * |
a14bc59f BP |
8 | * http://www.apache.org/licenses/LICENSE-2.0 |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
064af421 BP |
15 | */ |
16 | ||
17 | #ifndef DYNAMIC_STRING_H | |
18 | #define DYNAMIC_STRING_H 1 | |
19 | ||
20 | #include <stdarg.h> | |
21 | #include <stdbool.h> | |
22 | #include <stddef.h> | |
23 | #include <stdint.h> | |
24 | #include <stdio.h> | |
25 | #include "compiler.h" | |
26 | ||
27 | struct tm; | |
28 | ||
29 | struct ds { | |
30 | char *string; /* Null-terminated string. */ | |
31 | size_t length; /* Bytes used, not including null terminator. */ | |
32 | size_t allocated; /* Bytes allocated, not including null terminator. */ | |
33 | }; | |
34 | ||
35 | #define DS_EMPTY_INITIALIZER { NULL, 0, 0 } | |
36 | ||
37 | void ds_init(struct ds *); | |
38 | void ds_clear(struct ds *); | |
39 | void ds_truncate(struct ds *, size_t new_length); | |
40 | void ds_reserve(struct ds *, size_t min_length); | |
41 | char *ds_put_uninit(struct ds *, size_t n); | |
42 | void ds_put_char(struct ds *, char); | |
43 | void ds_put_char_multiple(struct ds *, char, size_t n); | |
44 | void ds_put_buffer(struct ds *, const char *, size_t n); | |
45 | void ds_put_cstr(struct ds *, const char *); | |
46 | void ds_put_format(struct ds *, const char *, ...) PRINTF_FORMAT(2, 3); | |
47 | void ds_put_format_valist(struct ds *, const char *, va_list) | |
48 | PRINTF_FORMAT(2, 0); | |
49 | void ds_put_printable(struct ds *, const char *, size_t); | |
50 | void ds_put_strftime(struct ds *, const char *, const struct tm *) | |
51 | STRFTIME_FORMAT(2); | |
52 | void ds_put_hex_dump(struct ds *ds, const void *buf_, size_t size, | |
53 | uintptr_t ofs, bool ascii); | |
54 | int ds_get_line(struct ds *, FILE *); | |
55 | ||
56 | char *ds_cstr(struct ds *); | |
48718554 | 57 | char *ds_steal_cstr(struct ds *); |
064af421 BP |
58 | void ds_destroy(struct ds *); |
59 | ||
60 | int ds_last(const struct ds *); | |
61 | void ds_chomp(struct ds *, int c); | |
62 | ||
63 | #endif /* dynamic-string.h */ |