avutil/dict: add warning to docs about invalidating existing entries when adding...
authorMarton Balint <cus@passwd.hu>
Sat, 6 Feb 2016 16:43:03 +0000 (17:43 +0100)
committerMarton Balint <cus@passwd.hu>
Mon, 14 Mar 2016 23:55:16 +0000 (00:55 +0100)
Reviewed-by: Michael Niedermayer <michael@niedermayer.cc>
Signed-off-by: Marton Balint <cus@passwd.hu>
libavutil/dict.h

index b0aa784..542d540 100644 (file)
@@ -116,6 +116,9 @@ int av_dict_count(const AVDictionary *m);
  * Note: If AV_DICT_DONT_STRDUP_KEY or AV_DICT_DONT_STRDUP_VAL is set,
  * these arguments will be freed on error.
  *
+ * Warning: Adding a new entry to a dictionary invalidates all existing entries
+ * previously returned with av_dict_get.
+ *
  * @param pm pointer to a pointer to a dictionary struct. If *pm is NULL
  * a dictionary struct is allocated and put in *pm.
  * @param key entry key to add to *pm (will be av_strduped depending on flags)