summaryrefslogtreecommitdiffstats
path: root/libreport/src/include/strbuf.h
diff options
context:
space:
mode:
authorJiri Moskovcak <jmoskovc@redhat.com>2011-06-08 17:27:42 +0200
committerJiri Moskovcak <jmoskovc@redhat.com>2011-06-08 17:27:42 +0200
commit0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e (patch)
treeb1249b7b96c908931f2c29f48f016da8be450429 /libreport/src/include/strbuf.h
parent7ac32c68dea1fe0c6efa6ac9bb0e8ad8716d7f7d (diff)
downloadabrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.tar.gz
abrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.tar.xz
abrt-0e74f780545b1aa8f6a5277b3cfdc9887c37ed5e.zip
split libreport to a separate package
Diffstat (limited to 'libreport/src/include/strbuf.h')
-rw-r--r--libreport/src/include/strbuf.h112
1 files changed, 112 insertions, 0 deletions
diff --git a/libreport/src/include/strbuf.h b/libreport/src/include/strbuf.h
new file mode 100644
index 00000000..44c6599a
--- /dev/null
+++ b/libreport/src/include/strbuf.h
@@ -0,0 +1,112 @@
+/*
+ strbuf.h - string buffer
+
+ Copyright (C) 2009 RedHat inc.
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License along
+ with this program; if not, write to the Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+*/
+#ifndef STRBUF_H
+#define STRBUF_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct strbuf
+{
+ /* Size of the allocated buffer. Always > 0. */
+ int alloc;
+ /* Length of the string, without the ending \0. */
+ int len;
+ char *buf;
+};
+
+/**
+ * Creates and initializes a new string buffer.
+ * @returns
+ * It never returns NULL. The returned pointer must be released by
+ * calling the function strbuf_free().
+ */
+#define strbuf_new abrt_strbuf_new
+struct strbuf *strbuf_new(void);
+
+/**
+ * Releases the memory held by the string buffer.
+ * @param strbuf
+ * If the strbuf is NULL, no operation is performed.
+ */
+#define strbuf_free abrt_strbuf_free
+void strbuf_free(struct strbuf *strbuf);
+
+/**
+ * Releases the strbuf, but not the internal buffer. The internal
+ * string buffer is returned. Caller is responsible to release the
+ * returned memory using free().
+ */
+#define strbuf_free_nobuf abrt_strbuf_free_nobuf
+char* strbuf_free_nobuf(struct strbuf *strbuf);
+
+/**
+ * The string content is set to an empty string, erasing any previous
+ * content and leaving its length at 0 characters.
+ */
+#define strbuf_clear abrt_strbuf_clear
+void strbuf_clear(struct strbuf *strbuf);
+
+/**
+ * The current content of the string buffer is extended by adding a
+ * character c at its end.
+ */
+#define strbuf_append_char abrt_strbuf_append_char
+struct strbuf *strbuf_append_char(struct strbuf *strbuf, char c);
+
+/**
+ * The current content of the string buffer is extended by adding a
+ * string str at its end.
+ */
+#define strbuf_append_str abrt_strbuf_append_str
+struct strbuf *strbuf_append_str(struct strbuf *strbuf,
+ const char *str);
+
+/**
+ * The current content of the string buffer is extended by inserting a
+ * string str at its beginning.
+ */
+#define strbuf_prepend_str abrt_strbuf_prepend_str
+struct strbuf *strbuf_prepend_str(struct strbuf *strbuf,
+ const char *str);
+
+/**
+ * The current content of the string buffer is extended by adding a
+ * sequence of data formatted as the format argument specifies.
+ */
+#define strbuf_append_strf abrt_strbuf_append_strf
+struct strbuf *strbuf_append_strf(struct strbuf *strbuf,
+ const char *format, ...);
+
+/**
+ * The current content of the string buffer is extended by inserting a
+ * sequence of data formatted as the format argument specifies at the
+ * buffer beginning.
+ */
+#define strbuf_prepend_strf abrt_strbuf_prepend_strf
+struct strbuf *strbuf_prepend_strf(struct strbuf *strbuf,
+ const char *format, ...);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif