aboutsummaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
authorXavier Del Campo Romero <xavi.dcr@tutanota.com>2020-08-03 23:47:18 +0200
committerXavier Del Campo Romero <xavi.dcr@tutanota.com>2020-08-03 23:47:18 +0200
commitfe3c74983c4ffc00d27e72cd76785f7bf2fefb47 (patch)
treeb3e6082098f4b8263185e1b71c7c58b567b732aa /include
parent3b94bbd2bd9e391ab0dcb8a116403f9d537c9886 (diff)
dynstr_prepend(), fixed typo in comment
Diffstat (limited to 'include')
-rw-r--r--include/dynstr.h14
1 files changed, 13 insertions, 1 deletions
diff --git a/include/dynstr.h b/include/dynstr.h
index dcdd8a1..7283de5 100644
--- a/include/dynstr.h
+++ b/include/dynstr.h
@@ -48,7 +48,7 @@
#define dynstr_append_or_ret_zero(...) if (dynstr_append(__VA_ARGS__) != DYNSTR_OK) return 0
/**
- * Convenience macro that calls dynstr_append and returns zero if failed.
+ * Convenience macro that calls dynstr_append and returns one if failed.
*/
#define dynstr_append_or_ret_nonzero(...) if (dynstr_append(__VA_ARGS__) != DYNSTR_OK) return 1
@@ -96,6 +96,18 @@ void dynstr_init(struct dynstr *d);
enum dynstr_err dynstr_append(struct dynstr *d, const char *format, ...);
/**
+ * This function takes a string literal in printf format and a variable
+ * number of arguments, calculates its size and prepends it into the
+ * beginning of the dynamic string.
+ * @param d Dynamic string where new string will be prepended.
+ * @param format String literal in printf format.
+ * @return Returns one of the following error codes:
+ * # DYNSTR_OK if successful.
+ * # DYNSTR_ERR_ALLOC if no more memory is available.
+ */
+enum dynstr_err dynstr_prepend(struct dynstr *d, const char *format, ...);
+
+/**
* This function duplicates a dynamic string to another instance.
* @attention Destination instance must be initialized before calling
* this function.