Parse the key/value pairs list in opts.

For each key/value pair found, stores the value in the field in ctx that is named like the key. ctx must be an AVClass context, storing is done using AVOptions.

Parameters

opts options string to parse, may be NULL

key_val_sep a 0-terminated list of characters used to separate key from value

pairs_sep a 0-terminated list of characters used to separate two pairs from each other

Returns

the number of successfully set key/value pairs, or a negative value corresponding to an AVERROR code in case of error: AVERROR(EINVAL) if opts cannot be parsed, the error code issued by av_opt_set() if a key/value pair cannot be set

Definition at line 1817 of file opt.c.

Referenced by avfilter_graph_segment_create_filters(), command(), ff_stream_add_bitstream_filter(), and main().

Parse the key-value pairs list in opts.

For each key=value pair found, set the value of the corresponding option in ctx.

Parameters

ctx the AVClass object to set options on

opts the options string, key-value pairs separated by a delimiter

shorthand a NULL-terminated array of options names for shorthand notation: if the first field in opts has no key part, the key is taken from the first element of shorthand; then again for the second, etc., until either opts is finished, shorthand is finished or a named option is found; after that, all options must be named

key_val_sep a 0-terminated list of characters used to separate key from value, for example '='

pairs_sep a 0-terminated list of characters used to separate two pairs from each other, for example ':' or ','

Returns

the number of successfully set key=value pairs, or a negative value corresponding to an AVERROR code in case of error: AVERROR(EINVAL) if opts cannot be parsed, the error code issued by av_set_string3() if a key/value pair cannot be set

Options names must use only the following characters: a-z A-Z 0-9 - . / _ Separators must use characters distinct from option names and from each other.

Definition at line 1897 of file opt.c.

Referenced by bsf_list_append_internal(), ff_dnn_init(), and main().

Set all the options from a given dictionary on an object.

Parameters

obj a struct whose first element is a pointer to AVClass

options options to process. This dictionary will be freed and replaced by a new one containing all options not found in obj. Of course this new dictionary needs to be freed by caller with av_dict_free().

Returns

0 on success, a negative AVERROR if some option was found in obj, but could not be set.

See also

av_dict_copy()

Definition at line 1986 of file opt.c.

Referenced by avformat_open_input(), avio_open_dir(), dynamic_set_parameter(), ff_http_do_new_request2(), ffurl_open_whitelist(), init_muxer(), of_parse_iamf_audio_element_layers(), of_parse_iamf_submixes(), and streamcopy_init().

Set all the options from a given dictionary on an object.

Parameters

obj a struct whose first element is a pointer to AVClass

options options to process. This dictionary will be freed and replaced by a new one containing all options not found in obj. Of course this new dictionary needs to be freed by caller with av_dict_free().

search_flags A combination of AV_OPT_SEARCH_*.

Returns

0 on success, a negative AVERROR if some option was found in obj, but could not be set.

See also

av_dict_copy()

Definition at line 1962 of file opt.c.

Referenced by av_opt_set_dict(), avcodec_open2(), avfilter_graph_segment_apply_opts(), avfilter_init_dict(), avformat_stream_group_create(), bsf_list_append_internal(), dec_open(), init_muxer(), list_devices_for_context(), of_parse_iamf_submixes(), and ost_add().

Copy options from src object into dest object.

The underlying AVClass of both src and dest must coincide. The guarantee below does not apply if this is not fulfilled.

Options that require memory allocation (e.g. string or binary) are malloc'ed in dest object. Original memory allocated for such options is freed unless both src and dest options points to the same memory.

Even on error it is guaranteed that allocated options from src and dest no longer alias each other afterwards; in particular calling av_opt_free() on both src and dest is safe afterwards if dest has been memdup'ed from src.

Parameters

dest Object to copy from

src Object to copy into

Returns

0 on success, negative on error

Definition at line 2151 of file opt.c.

Referenced by command(), context_init_threaded(), ff_frame_thread_encoder_init(), ffurl_open_whitelist(), init_legacy_subpass(), init_thread(), and sws_getCachedContext().