2 * Copyright (c) 2008, 2009, 2010, 2011 Nicira Networks.
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:
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 #include "dynamic-string.h"
27 ds_init(struct ds *ds)
35 ds_clear(struct ds *ds)
41 ds_truncate(struct ds *ds, size_t new_length)
43 if (ds->length > new_length) {
44 ds->length = new_length;
45 ds->string[new_length] = '\0';
50 ds_reserve(struct ds *ds, size_t min_length)
52 if (min_length > ds->allocated || !ds->string) {
53 ds->allocated += MAX(min_length, ds->allocated);
54 ds->allocated = MAX(8, ds->allocated);
55 ds->string = xrealloc(ds->string, ds->allocated + 1);
60 ds_put_uninit(struct ds *ds, size_t n)
62 ds_reserve(ds, ds->length + n);
64 ds->string[ds->length] = '\0';
65 return &ds->string[ds->length - n];
69 ds_put_char__(struct ds *ds, char c)
71 *ds_put_uninit(ds, 1) = c;
74 /* Appends unicode code point 'uc' to 'ds' in UTF-8 encoding. */
76 ds_put_utf8(struct ds *ds, int uc)
80 } else if (uc <= 0x7ff) {
81 ds_put_char(ds, 0xc0 | (uc >> 6));
82 ds_put_char(ds, 0x80 | (uc & 0x3f));
83 } else if (uc <= 0xffff) {
84 ds_put_char(ds, 0xe0 | (uc >> 12));
85 ds_put_char(ds, 0x80 | ((uc >> 6) & 0x3f));
86 ds_put_char(ds, 0x80 | (uc & 0x3f));
87 } else if (uc <= 0x10ffff) {
88 ds_put_char(ds, 0xf0 | (uc >> 18));
89 ds_put_char(ds, 0x80 | ((uc >> 12) & 0x3f));
90 ds_put_char(ds, 0x80 | ((uc >> 6) & 0x3f));
91 ds_put_char(ds, 0x80 | (uc & 0x3f));
93 /* Invalid code point. Insert the Unicode general substitute
94 * REPLACEMENT CHARACTER. */
95 ds_put_utf8(ds, 0xfffd);
100 ds_put_char_multiple(struct ds *ds, char c, size_t n)
102 memset(ds_put_uninit(ds, n), c, n);
106 ds_put_buffer(struct ds *ds, const char *s, size_t n)
108 memcpy(ds_put_uninit(ds, n), s, n);
112 ds_put_cstr(struct ds *ds, const char *s)
114 size_t s_len = strlen(s);
115 memcpy(ds_put_uninit(ds, s_len), s, s_len);
119 ds_put_and_free_cstr(struct ds *ds, char *s)
126 ds_put_format(struct ds *ds, const char *format, ...)
130 va_start(args, format);
131 ds_put_format_valist(ds, format, args);
136 ds_put_format_valist(struct ds *ds, const char *format, va_list args_)
142 va_copy(args, args_);
143 available = ds->string ? ds->allocated - ds->length + 1 : 0;
144 needed = vsnprintf(&ds->string[ds->length], available, format, args);
147 if (needed < available) {
148 ds->length += needed;
150 ds_reserve(ds, ds->length + needed);
152 va_copy(args, args_);
153 available = ds->allocated - ds->length + 1;
154 needed = vsnprintf(&ds->string[ds->length], available, format, args);
157 assert(needed < available);
158 ds->length += needed;
163 ds_put_printable(struct ds *ds, const char *s, size_t n)
165 ds_reserve(ds, ds->length + n);
167 unsigned char c = *s++;
168 if (c < 0x20 || c > 0x7e || c == '\\' || c == '"') {
169 ds_put_format(ds, "\\%03o", (int) c);
176 /* Writes the current time to 'string' based on 'template'.
177 * The current time is either localtime or UTC based on 'utc'. */
179 ds_put_strftime(struct ds *ds, const char *template, bool utc)
182 time_t now = time_wall();
186 tm = localtime(&now);
190 size_t avail = ds->string ? ds->allocated - ds->length + 1 : 0;
191 size_t used = strftime(&ds->string[ds->length], avail, template, tm);
196 ds_reserve(ds, ds->length + (avail < 32 ? 64 : 2 * avail));
201 ds_get_line(struct ds *ds, FILE *file)
207 return ds->length ? 0 : EOF;
208 } else if (c == '\n') {
216 /* Reads a line from 'file' into 'ds', clearing anything initially in 'ds'.
217 * Deletes comments introduced by "#" and skips lines that contains only white
218 * space (after deleting comments).
220 * Returns 0 if successful, EOF if no non-blank line was found. */
222 ds_get_preprocessed_line(struct ds *ds, FILE *file)
224 while (!ds_get_line(ds, file)) {
225 char *line = ds_cstr(ds);
228 /* Delete comments. */
229 comment = strchr(line, '#');
234 /* Return successfully unless the line is all spaces. */
235 if (line[strspn(line, " \t\n")] != '\0') {
243 ds_cstr(struct ds *ds)
248 ds->string[ds->length] = '\0';
253 ds_cstr_ro(const struct ds *ds)
255 return ds_cstr((struct ds *) ds);
258 /* Returns a null-terminated string representing the current contents of 'ds',
259 * which the caller is expected to free with free(), then clears the contents
262 ds_steal_cstr(struct ds *ds)
264 char *s = ds_cstr(ds);
270 ds_destroy(struct ds *ds)
275 /* Swaps the content of 'a' and 'b'. */
277 ds_swap(struct ds *a, struct ds *b)
284 /* Writes the 'size' bytes in 'buf' to 'string' as hex bytes arranged 16 per
285 * line. Numeric offsets are also included, starting at 'ofs' for the first
286 * byte in 'buf'. If 'ascii' is true then the corresponding ASCII characters
287 * are also rendered alongside. */
289 ds_put_hex_dump(struct ds *ds, const void *buf_, size_t size,
290 uintptr_t ofs, bool ascii)
292 const uint8_t *buf = buf_;
293 const size_t per_line = 16; /* Maximum bytes per line. */
297 size_t start, end, n;
300 /* Number of bytes on this line. */
301 start = ofs % per_line;
303 if (end - start > size)
308 ds_put_format(ds, "%08jx ", (uintmax_t) ROUND_DOWN(ofs, per_line));
309 for (i = 0; i < start; i++)
310 ds_put_format(ds, " ");
312 ds_put_format(ds, "%02hhx%c",
313 buf[i - start], i == per_line / 2 - 1? '-' : ' ');
316 for (; i < per_line; i++)
317 ds_put_format(ds, " ");
318 ds_put_format(ds, "|");
319 for (i = 0; i < start; i++)
320 ds_put_format(ds, " ");
321 for (; i < end; i++) {
322 int c = buf[i - start];
323 ds_put_char(ds, c >= 32 && c < 127 ? c : '.');
325 for (; i < per_line; i++)
326 ds_put_format(ds, " ");
327 ds_put_format(ds, "|");
329 ds_put_format(ds, "\n");
338 ds_last(const struct ds *ds)
340 return ds->length > 0 ? (unsigned char) ds->string[ds->length - 1] : EOF;
344 ds_chomp(struct ds *ds, int c)
346 if (ds->length > 0 && ds->string[ds->length - 1] == (char) c) {
347 ds->string[--ds->length] = '\0';