Implement av_strlcatf(): a strlcat which adds a printf style formatted string
[ffmpeg.git] / libavutil / avstring.h
index bc24ea14d1539b4725c7c4674737a5599c438f11..f25dd31d035496f84bd196023d99ed8cef3615c8 100644 (file)
@@ -73,4 +73,18 @@ size_t av_strlcpy(char *dst, const char *src, size_t size);
  */
 size_t av_strlcat(char *dst, const char *src, size_t size);
 
+/**
+ * Append output to a string, according to a format. Never write out of
+ * the destination buffer, and and always put a terminating 0 within
+ * the buffer.
+ * @param dst destination buffer (string to which the output is
+ *  appended)
+ * @param size total size of the destination buffer
+ * @param fmt printf-compatible format string, specifying how the
+ *  following parameters are used
+ * @return the length of the string that would have been generated
+ *  if enough space had been available
+ */
+size_t av_strlcatf(char *dst, size_t size, const char *fmt, ...);
+
 #endif /* AVUTIL_STRING_H */