dstring: Add a printf()-style creation API

1 files changed, 14 insertions, 0 deletions

diff --git a/dstring.h b/dstring.h
index 0374447..22476b9 100644
--- a/dstring.h
+++ b/dstring.h
@@ -21,6 +21,7 @@
 #ifndef BFS_DSTRING_H
 #define BFS_DSTRING_H
 
+#include "util.h"
 #include <stddef.h>
 
 /**
@@ -106,6 +107,19 @@ int dstrncat(char **dest, const char *src, size_t n);
 int dstrapp(char **str, char c);
 
 /**
+ * Create a dynamic string from a format string.
+ *
+ * @param format
+ *         The format string to fill in.
+ * @param ...
+ *         Any arguments for the format string.
+ * @return
+ *         The created string, or NULL on failure.
+ */
+BFS_FORMATTER(1, 2)
+char *dstrprintf(const char *format, ...);
+
+/**
  * Free a dynamic string.
  *
  * @param dstr