Code

utils strbuf: Added an automatically growing string implementation.
[sysdb.git] / src / utils / strbuf.c
1 /*
2  * SysDB - src/utils/strbuf.c
3  * Copyright (C) 2012 Sebastian 'tokkee' Harl <sh@tokkee.org>
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
19  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
20  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
22  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
23  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
24  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
25  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
28 #include "utils/strbuf.h"
30 #include <assert.h>
32 #include <stdio.h>
33 #include <stdlib.h>
34 #include <stdarg.h>
36 /*
37  * private data structures
38  */
40 struct sdb_strbuf {
41         char  *string;
42         size_t size;
43         size_t pos;
44 };
46 /*
47  * private helper functions
48  */
50 static int
51 strbuf_resize(sdb_strbuf_t *strbuf)
52 {
53         char *tmp;
55         assert(strbuf->size);
57         tmp = realloc(strbuf->string, 2 * strbuf->size);
58         if (! tmp)
59                 return -1;
61         strbuf->string = tmp;
62         strbuf->size *= 2;
63         return 0;
64 } /* strbuf_resize */
66 /*
67  * public API
68  */
70 sdb_strbuf_t *
71 sdb_strbuf_create(size_t size)
72 {
73         sdb_strbuf_t *strbuf;
75         if (! size)
76                 return NULL;
78         strbuf = calloc(1, sizeof(*strbuf));
79         if (! strbuf)
80                 return NULL;
82         strbuf->string = malloc(size);
83         if (! strbuf->string) {
84                 free(strbuf);
85                 return NULL;
86         }
88         strbuf->string[0] = '\0';
89         strbuf->size = size;
90         strbuf->pos  = 0;
92         return strbuf;
93 } /* sdb_strbuf_create */
95 void
96 sdb_strbuf_destroy(sdb_strbuf_t *strbuf)
97 {
98         if (! strbuf)
99                 return;
101         free(strbuf->string);
102         free(strbuf);
103 } /* sdb_strbuf_destroy */
105 ssize_t
106 sdb_strbuf_vappend(sdb_strbuf_t *strbuf, const char *fmt, va_list ap)
108         int status;
110         if ((! strbuf) || (! fmt))
111                 return -1;
113         assert(strbuf->string[strbuf->pos] == '\0');
115         if (strbuf->pos >= strbuf->size)
116                 if (strbuf_resize(strbuf))
117                         return -1;
119         status = vsnprintf(strbuf->string + strbuf->pos,
120                         strbuf->size - strbuf->pos, fmt, ap);
122         if (status < 0)
123                 return status;
125         if ((size_t)status >= strbuf->size - strbuf->pos) {
126                 strbuf_resize(strbuf);
128                 /* reset string and try again */
129                 strbuf->string[strbuf->pos] = '\0';
130                 return sdb_strbuf_vappend(strbuf, fmt, ap);
131         }
133         strbuf->pos += (size_t)status;
134         return (ssize_t)status;
135 } /* sdb_strbuf_vappend */
137 ssize_t
138 sdb_strbuf_append(sdb_strbuf_t *strbuf, const char *fmt, ...)
140         va_list ap;
141         ssize_t status;
143         va_start(ap, fmt);
144         status = sdb_strbuf_vappend(strbuf, fmt, ap);
145         va_end(ap);
147         return status;
148 } /* sdb_strbuf_append */
150 ssize_t
151 sdb_strbuf_vsprintf(sdb_strbuf_t *strbuf, const char *fmt, va_list ap)
153         if (! strbuf)
154                 return -1;
156         strbuf->string[0] = '\0';
157         strbuf->pos = 0;
159         return sdb_strbuf_vappend(strbuf, fmt, ap);
160 } /* sdb_strbuf_vsprintf */
162 ssize_t
163 sdb_strbuf_sprintf(sdb_strbuf_t *strbuf, const char *fmt, ...)
165         va_list ap;
166         ssize_t status;
168         va_start(ap, fmt);
169         status = sdb_strbuf_vsprintf(strbuf, fmt, ap);
170         va_end(ap);
172         return status;
173 } /* sdb_strbuf_sprintf */
175 const char *
176 sdb_strbuf_string(sdb_strbuf_t *strbuf)
178         if (! strbuf)
179                 return NULL;
180         return strbuf->string;
181 } /* sdb_strbuf_string */
183 size_t
184 sdb_strbuf_len(sdb_strbuf_t *strbuf)
186         if (! strbuf)
187                 return 0;
188         return strbuf->pos;
189 } /* sdb_strbuf_string */
191 /* vim: set tw=78 sw=4 ts=4 noexpandtab : */