4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
8 PulseAudio is free software; you can redistribute it and/or modify
9 it under the terms of the GNU Lesser General Public License as published
10 by the Free Software Foundation; either version 2 of the License,
11 or (at your option) any later version.
13 PulseAudio is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with PulseAudio; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
28 #include <sys/types.h>
35 #include <pulse/xmalloc.h>
39 /* A chunk of the linked list that makes up the string */
45 #define CHUNK_TO_TEXT(c) ((char*) (c) + sizeof(struct chunk))
49 struct chunk *head, *tail;
52 pa_strbuf *pa_strbuf_new(void) {
53 pa_strbuf *sb = pa_xmalloc(sizeof(pa_strbuf));
55 sb->head = sb->tail = NULL;
59 void pa_strbuf_free(pa_strbuf *sb) {
62 struct chunk *c = sb->head;
63 sb->head = sb->head->next;
70 /* Make a C string from the string buffer. The caller has to free
71 * string with pa_xfree(). */
72 char *pa_strbuf_tostring(pa_strbuf *sb) {
77 e = t = pa_xmalloc(sb->length+1);
79 for (c = sb->head; c; c = c->next) {
80 assert((size_t) (e-t) <= sb->length);
81 memcpy(e, CHUNK_TO_TEXT(c), c->length);
88 assert(e == t+sb->length);
93 /* Combination of pa_strbuf_free() and pa_strbuf_tostring() */
94 char *pa_strbuf_tostring_free(pa_strbuf *sb) {
97 t = pa_strbuf_tostring(sb);
102 /* Append a string to the string buffer */
103 void pa_strbuf_puts(pa_strbuf *sb, const char *t) {
105 pa_strbuf_putsn(sb, t, strlen(t));
108 /* Append a new chunk to the linked list */
109 static void append(pa_strbuf *sb, struct chunk *c) {
121 sb->length += c->length;
125 /* Append up to l bytes of a string to the string buffer */
126 void pa_strbuf_putsn(pa_strbuf *sb, const char *t, size_t l) {
133 c = pa_xmalloc(sizeof(struct chunk)+l);
135 memcpy(CHUNK_TO_TEXT(c), t, l);
140 /* Append a printf() style formatted string to the string buffer. */
141 /* The following is based on an example from the GNU libc documentation */
142 int pa_strbuf_printf(pa_strbuf *sb, const char *format, ...) {
144 struct chunk *c = NULL;
152 c = pa_xrealloc(c, sizeof(struct chunk)+size);
154 va_start(ap, format);
155 r = vsnprintf(CHUNK_TO_TEXT(c), size, format, ap);
158 if (r > -1 && r < size) {
164 if (r > -1) /* glibc 2.1 */