AVOptions: add av_opt_next, deprecate av_next_option.
authorAnton Khirnov <anton@khirnov.net>
Mon, 3 Oct 2011 18:04:07 +0000 (20:04 +0200)
committerAnton Khirnov <anton@khirnov.net>
Wed, 12 Oct 2011 14:51:16 +0000 (16:51 +0200)
Just for naming consistency, no functional changes.

libavutil/opt.c
libavutil/opt.h

index 8af2ac2..7667d49 100644 (file)
@@ -47,8 +47,15 @@ const AVOption *av_find_opt(void *v, const char *name, const char *unit, int mas
 }
 #endif
 
+#if FF_API_OLD_AVOPTIONS
 const AVOption *av_next_option(void *obj, const AVOption *last)
 {
+    return av_opt_next(obj, last);
+}
+#endif
+
+const AVOption *av_opt_next(void *obj, const AVOption *last)
+{
     if (last && last[1].name) return ++last;
     else if (last)            return NULL;
     else                      return (*(AVClass**)obj)->option;
index 7649447..e30f012 100644 (file)
@@ -150,8 +150,8 @@ attribute_deprecated double av_get_double(void *obj, const char *name, const AVO
 attribute_deprecated AVRational av_get_q(void *obj, const char *name, const AVOption **o_out);
 attribute_deprecated int64_t av_get_int(void *obj, const char *name, const AVOption **o_out);
 attribute_deprecated const char *av_get_string(void *obj, const char *name, const AVOption **o_out, char *buf, int buf_len);
+attribute_deprecated const AVOption *av_next_option(void *obj, const AVOption *last);
 #endif
-const AVOption *av_next_option(void *obj, const AVOption *last);
 
 /**
  * Show the obj options.
@@ -310,6 +310,17 @@ const AVOption *av_opt_find2(void *obj, const char *name, const char *unit,
                              int opt_flags, int search_flags, void **target_obj);
 
 /**
+ * Iterate over all AVOptions belonging to obj.
+ *
+ * @param obj an AVOptions-enabled struct or a double pointer to an
+ *            AVClass describing it.
+ * @param prev result of the previous call to av_opt_next() on this object
+ *             or NULL
+ * @return next AVOption or NULL
+ */
+const AVOption *av_opt_next(void *obj, const AVOption *prev);
+
+/**
  * Iterate over AVOptions-enabled children of obj.
  *
  * @param prev result of a previous call to this function or NULL