2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published
8 by the Free Software Foundation; either version 2.1 of the License,
9 or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
26 #include <sys/types.h>
32 #include <pulse/xmalloc.h>
33 #include <pulsecore/macro.h>
37 /* A chunk of the linked list that makes up the string */
43 #define CHUNK_TO_TEXT(c) ((char*) (c) + PA_ALIGN(sizeof(struct chunk)))
47 struct chunk *head, *tail;
50 pa_strbuf *pa_strbuf_new(void) {
53 sb = pa_xnew(pa_strbuf, 1);
55 sb->head = sb->tail = NULL;
60 void pa_strbuf_free(pa_strbuf *sb) {
64 struct chunk *c = sb->head;
65 sb->head = sb->head->next;
72 /* Make a C string from the string buffer. The caller has to free
73 * string with pa_xfree(). */
74 char *pa_strbuf_tostring(pa_strbuf *sb) {
80 e = t = pa_xmalloc(sb->length+1);
82 for (c = sb->head; c; c = c->next) {
83 pa_assert((size_t) (e-t) <= sb->length);
84 memcpy(e, CHUNK_TO_TEXT(c), c->length);
91 pa_assert(e == t+sb->length);
96 /* Combination of pa_strbuf_free() and pa_strbuf_tostring() */
97 char *pa_strbuf_tostring_free(pa_strbuf *sb) {
101 t = pa_strbuf_tostring(sb);
107 /* Append a string to the string buffer */
108 void pa_strbuf_puts(pa_strbuf *sb, const char *t) {
113 pa_strbuf_putsn(sb, t, strlen(t));
116 /* Append a character to the string buffer */
117 void pa_strbuf_putc(pa_strbuf *sb, char c) {
120 pa_strbuf_putsn(sb, &c, 1);
123 /* Append a new chunk to the linked list */
124 static void append(pa_strbuf *sb, struct chunk *c) {
132 pa_assert(!sb->head);
137 sb->length += c->length;
141 /* Append up to l bytes of a string to the string buffer */
142 void pa_strbuf_putsn(pa_strbuf *sb, const char *t, size_t l) {
151 c = pa_xmalloc(PA_ALIGN(sizeof(struct chunk)) + l);
153 memcpy(CHUNK_TO_TEXT(c), t, l);
158 /* Append a printf() style formatted string to the string buffer. */
159 /* The following is based on an example from the GNU libc documentation */
160 size_t pa_strbuf_printf(pa_strbuf *sb, const char *format, ...) {
162 struct chunk *c = NULL;
171 c = pa_xrealloc(c, PA_ALIGN(sizeof(struct chunk)) + size);
173 va_start(ap, format);
174 r = vsnprintf(CHUNK_TO_TEXT(c), size, format, ap);
175 CHUNK_TO_TEXT(c)[size-1] = 0;
178 if (r > -1 && (size_t) r < size) {
179 c->length = (size_t) r;
184 if (r > -1) /* glibc 2.1 */
191 pa_bool_t pa_strbuf_isempty(pa_strbuf *sb) {
194 return sb->length <= 0;