changeset 778:81aecbb6bbb2 libavutil

Add warnings to av_strlcat and av_strlcpy doxygen that the input strings already must be properly 0-terminated strings. Unlike strncpy it cannot be used on raw data read from a file.

--- a/avstring.h	Sun Sep 06 00:08:19 2009 +0000
+++ b/avstring.h	Wed Sep 09 21:00:51 2009 +0000
@@ -56,6 +56,10 @@
  * @param src source string
  * @param size size of destination buffer
  * @return the length of src
+ *
+ * WARNING: since the return value is the length of src, src absolutely
+ * _must_ be a properly 0-terminated string, otherwise this will read beyond
+ * the end of the buffer and possibly crash.
  */
 size_t av_strlcpy(char *dst, const char *src, size_t size);
 
@@ -70,6 +74,10 @@
  * @param src source string
  * @param size size of destination buffer
  * @return the total length of src and dst
+ *
+ * WARNING: since the return value use the length of src and dst, these absolutely
+ * _must_ be a properly 0-terminated strings, otherwise this will read beyond
+ * the end of the buffer and possibly crash.
  */
 size_t av_strlcat(char *dst, const char *src, size_t size);