FFmpeg
[フレーム]
Data Structures | Functions
AVDictionary
libavutil » Data Structures

Simple key:value store. More...

Data Structures

struct   AVDictionaryEntry
 

Functions

AVDictionaryEntryav_dict_get (const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
  Get a dictionary entry with matching key. More...
 
  Iterate over a dictionary. More...
 
int  av_dict_count (const AVDictionary *m)
  Get number of entries in dictionary. More...
 
int  av_dict_set (AVDictionary **pm, const char *key, const char *value, int flags)
  Set the given entry in *pm, overwriting an existing entry. More...
 
int  av_dict_set_int (AVDictionary **pm, const char *key, int64_t value, int flags)
  Convenience wrapper for av_dict_set() that converts the value to a string and stores it. More...
 
int  av_dict_parse_string (AVDictionary **pm, const char *str, const char *key_val_sep, const char *pairs_sep, int flags)
  Parse the key/value pairs list and add the parsed entries to a dictionary. More...
 
  Copy entries from one AVDictionary struct into another. More...
 
  Free all the memory allocated for an AVDictionary struct and all keys and values. More...
 
int  av_dict_get_string (const AVDictionary *m, char **buffer, const char key_val_sep, const char pairs_sep)
  Get dictionary entries as a string. More...
 

AVDictionary Flags

Flags that influence behavior of the matching of keys or insertion to the dictionary.

#define  AV_DICT_MATCH_CASE   1
  Only get an entry with exact-case key match. More...
 
#define  AV_DICT_IGNORE_SUFFIX   2
  Return first entry in a dictionary whose first part corresponds to the search key, ignoring the suffix of the found key string. More...
 
#define  AV_DICT_DONT_STRDUP_KEY   4
  Take ownership of a key that's been allocated with av_malloc() or another memory allocation function. More...
 
#define  AV_DICT_DONT_STRDUP_VAL   8
  Take ownership of a value that's been allocated with av_malloc() or another memory allocation function. More...
 
#define  AV_DICT_DONT_OVERWRITE   16
  Don't overwrite existing entries. More...
 
#define  AV_DICT_APPEND   32
  If the entry already exists, append to it. More...
 
#define  AV_DICT_MULTIKEY   64
  Allow to store several equal keys in the dictionary. More...
 
#define  AV_DICT_DEDUP   128
  If inserting a value that already exists for a key, do nothing. More...
 

Detailed Description

Simple key:value store.

Dictionaries are used for storing key-value pairs.

AVDictionary *d = NULL; // "create" an empty dictionary
AVDictionaryEntry *t = NULL;
av_dict_set(&d, "foo", "bar", 0); // add an entry
char *k = av_strdup("key"); // if your strings are already allocated,
char *v = av_strdup("value"); // you can avoid copying them like this
av_dict_set(&d, k, v, AV_DICT_DONT_STRDUP_KEY | AV_DICT_DONT_STRDUP_VAL);
while ((t = av_dict_iterate(d, t))) {
<....> // iterate over all entries in d
}
av_dict_free(&d);

Macro Definition Documentation

AV_DICT_MATCH_CASE

#define AV_DICT_MATCH_CASE   1

Only get an entry with exact-case key match.

Only relevant in av_dict_get().

Definition at line 74 of file dict.h.

AV_DICT_IGNORE_SUFFIX

#define AV_DICT_IGNORE_SUFFIX   2

Return first entry in a dictionary whose first part corresponds to the search key, ignoring the suffix of the found key string.

Only relevant in av_dict_get().

Definition at line 75 of file dict.h.

AV_DICT_DONT_STRDUP_KEY

#define AV_DICT_DONT_STRDUP_KEY   4

Take ownership of a key that's been allocated with av_malloc() or another memory allocation function.

Definition at line 77 of file dict.h.

AV_DICT_DONT_STRDUP_VAL

#define AV_DICT_DONT_STRDUP_VAL   8

Take ownership of a value that's been allocated with av_malloc() or another memory allocation function.

Definition at line 79 of file dict.h.

AV_DICT_DONT_OVERWRITE

#define AV_DICT_DONT_OVERWRITE   16

Don't overwrite existing entries.

Definition at line 81 of file dict.h.

AV_DICT_APPEND

#define AV_DICT_APPEND   32

If the entry already exists, append to it.

Note that no delimiter is added, the strings are simply concatenated.

Definition at line 82 of file dict.h.

AV_DICT_MULTIKEY

#define AV_DICT_MULTIKEY   64

Allow to store several equal keys in the dictionary.

Definition at line 84 of file dict.h.

AV_DICT_DEDUP

#define AV_DICT_DEDUP   128

If inserting a value that already exists for a key, do nothing.

Only relevant with AV_DICT_MULTIKEY.

Definition at line 85 of file dict.h.

Function Documentation

av_dict_get()

AVDictionaryEntry* av_dict_get ( const AVDictionarym,
const char *  key,
const AVDictionaryEntryprev,
int  flags 
)

Get a dictionary entry with matching key.

The returned entry key or value must not be changed, or it will cause undefined behavior.

Parameters
prev Set to the previous matching element to find the next. If set to NULL the first matching element is returned.
key Matching key
flags A collection of AV_DICT_* flags controlling how the entry is retrieved
Returns
Found entry or NULL in case no matching entry was found in the dictionary

Definition at line 60 of file dict.c.

Referenced by aea_write_header(), asf_write_header1(), asf_write_markers(), av_dict_set(), av_dump_format(), avcodec_open2(), avi_read_header(), avi_write_header(), avtext_print_integer(), avtext_print_string(), bitstream_switching(), check_avoptions_used(), check_extensions(), check_layers(), check_opt_bitexact(), cuda_flags_from_opts(), d3d11va_device_create(), d3d12va_device_create(), dec_enc(), dec_open(), dict_copy_entry(), dict_iterate(), dump_attachment(), dump_metadata(), dump_stream_format(), dv_write_header(), dynamic_set_parameter(), export_orphan_timecode(), ff_decklink_read_packet(), ff_id3v2_write_apic(), ff_parse_creation_time_metadata(), ff_qsv_enc_init(), ff_replaygain_export(), ff_resman_get_string(), ff_riff_write_info(), ffurl_connect(), ffurl_open_whitelist(), filter_frame(), find_compressor(), flac_init(), flac_read_header(), flac_write_picture(), flv_read_packet(), func_frame_metadata(), get_concatdec_select(), get_cookies(), get_date_tag(), get_duration(), get_metadata_duration(), get_metadata_lang(), get_mimetype(), gxf_write_header(), has_link_pair(), id3_has_changed_values(), id3v1_create_tag(), id3v1_set_string(), ifile_open(), imf_read_header(), init_muxer(), ist_add(), main(), match_stream_specifier(), mkv_write_attachments(), mkv_write_chapters(), mkv_write_header(), mkv_write_info(), mkv_write_stereo_mode(), mkv_write_track(), mkv_write_track_video(), mov_create_chapter_track(), mov_init(), mov_parse_stsd_audio(), mov_read_header(), mov_write_3gp_udta_tag(), mov_write_chpl_tag(), mov_write_hdlr_tag(), mov_write_header(), mov_write_int8_metadata(), mov_write_isml_manifest(), mov_write_raw_metadata_tag(), mov_write_SA3D_tag(), mov_write_tmcd_tag(), mov_write_tmpo_tag(), mov_write_track_metadata(), mov_write_trkn_tag(), mov_write_uuidusmt_tag(), mp3_write_xing(), mpegts_add_service(), mpegts_init(), mpegts_write_pmt(), multiview_check_manual(), mxf_init(), mxf_init_timecode(), mxf_write_header_metadata_sets(), mxf_write_identification(), mxf_write_user_comments(), of_add_programs(), of_parse_group_token(), of_parse_iamf_submixes(), open_input_file(), open_slave(), opencl_filter_device(), opencl_filter_platform(), ost_add(), parse_cookie(), png_write_iccp(), print_filter(), print_filtergraph_single(), print_frame_side_data(), put_meta(), qsv_device_create(), read_thread(), receiver_thread(), redirect_cache_get(), riff_has_valid_tags(), rv10_write_header(), sap_write_header(), segment_end(), set_skip_frame_encode_ctrl(), sox_write_header(), stream_component_open(), stream_specifier_match(), subsegment_alignment(), ttml_write_header(), update_settings(), vaapi_device_create(), vorbis_parse_single_comment(), vpx_encode(), vulkan_device_create_internal(), write_adaptation_set(), write_manifest(), write_representation(), write_table_entries_attrib(), and write_table_redirector_legacy_attrib().

av_dict_iterate()

const AVDictionaryEntry* av_dict_iterate ( const AVDictionarym,
const AVDictionaryEntryprev 
)

Iterate over a dictionary.

Iterates through all entries in the dictionary.

Warning
The returned AVDictionaryEntry key/value must not be changed.
As av_dict_set() invalidates all previous entries returned by this function, it must not be called while iterating over the dict.

Typical usage:

while ((e = av_dict_iterate(m, e))) {
// ...
}
Parameters
m The dictionary to iterate over
prev Pointer to the previous AVDictionaryEntry, NULL initially
Return values
AVDictionaryEntry* The next element in the dictionary
NULL No more elements in the dictionary

Definition at line 42 of file dict.c.

Referenced by aom_init(), asf_write_header1(), av_dict_copy(), av_dict_get(), av_dict_get_string(), av_opt_is_set_to_default(), av_opt_set_dict2(), av_packet_pack_dictionary(), avfilter_init_str(), avtext_context_open(), caf_write_header(), check_avoptions(), check_avoptions_used(), config_enc_params(), configure_audio_filters(), configure_output_video_filter(), configure_video_filters(), cookie_string(), create_filter(), dict_iterate(), dump_dictionary(), ff_ape_write_tag(), ff_metadata_conv(), ff_vorbiscomment_length(), ff_vorbiscomment_write(), fifo_thread_write_header(), filter_codec_opts(), filter_frame(), get_conf(), get_cookies(), graph_opts_apply(), iamf_write_mixing_presentation(), id3_has_changed_values(), id3v2_3_metadata_split_date(), init(), libkvazaar_init(), librav1e_encode_init(), libx265_encode_init(), libxeve_init(), log_unknown_opt(), lrc_write_header(), main(), mc_device_create(), mkv_write_tag(), mov_write_mdta_ilst_tag(), mov_write_mdta_keys_tag(), of_add_programs(), of_parse_group_token(), of_parse_iamf_audio_element_layers(), of_parse_iamf_submixes(), open_input_file(), open_slave(), parse_cookie(), parse_features(), parse_models(), print_iamf_mix_presentation_params(), print_iamf_submix_params(), remove_avoptions(), show_tags(), smjpeg_write_header(), vpx_init(), vvenc_parse_vvenc_params(), write_chapter(), write_globalinfo(), write_metadata(), write_streaminfo(), write_table_entries_attrib(), write_table_redirector_legacy_attrib(), write_tags(), X264_init(), and xavs2_init().

av_dict_count()

int av_dict_count ( const AVDictionarym )

Get number of entries in dictionary.

Parameters
m dictionary
Returns
number of entries in dictionary

Definition at line 37 of file dict.c.

Referenced by adts_aac_read_header(), asf_write_header1(), av_dict_get_string(), avfilter_graph_segment_apply_opts(), caf_write_header(), config_enc_params(), configure_filtergraph(), dump_metadata(), ff_vorbiscomment_write(), hls_mux_init(), http_open_cnx(), iamf_write_mixing_presentation(), init(), main(), mp3_read_header(), mpc_read_header(), ogg_build_vp8_headers(), seg_init(), update_settings(), and wv_read_header().

av_dict_set()

int av_dict_set ( AVDictionary **  pm,
const char *  key,
const char *  value,
int  flags 
)

Set the given entry in *pm, overwriting an existing entry.

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() or av_dict_iterate().
Parameters
pm Pointer to a pointer to a dictionary struct. If *pm is NULL a dictionary struct is allocated and put in *pm.
key Entry key to add to *pm (will either be av_strduped or added as a new key depending on flags)
value Entry value to add to *pm (will be av_strduped or added as a new key depending on flags). Passing a NULL value will cause an existing entry to be deleted.
Returns
>= 0 on success otherwise an error code <0

Definition at line 86 of file dict.c.

Referenced by aa_read_header(), add_filename_as_pkt_side_data(), add_meta(), add_metadata(), add_metadata_from_renditions(), add_timecode_metadata(), aea_read_header(), amf_parse_object(), ape_tag_read_field(), asf_read_header(), asf_read_metadata(), asf_read_picture(), asf_read_properties(), asf_read_value(), asf_set_metadata(), asf_write_header1(), av_dict_copy(), av_dict_set_fxp(), av_dict_set_int(), av_opt_set_dict2(), av_packet_unpack_dictionary(), avformat_find_stream_info(), avi_metadata_creation_time(), avi_read_nikon(), avi_read_tag(), avpriv_new_chapter(), bprint_to_avdict(), chunk_end(), cine_read_header(), concat_parse_script(), config_input(), config_props(), copy_meta(), copy_tls_opts_dict(), create_rtp_muxer(), dash_init(), dash_read_header(), dashenc_delete_file(), dec_open(), decode_frame(), decode_frame_common(), decode_header(), decode_info_header(), decode_text_chunk(), dict_copy_entry(), dict_set_if_not_null(), dispose_session(), dss_read_metadata_date(), dss_read_metadata_string(), dtshd_read_header(), dvdvideo_audio_stream_add(), dvdvideo_subp_stream_add(), evaluate(), exchange_sdp(), exif_ifd_to_dict(), export_orphan_timecode(), ff_dict_set_timestamp(), ff_filter_opt_parse(), ff_flac_parse_picture(), ff_id3v2_parse_apic(), ff_id3v2_parse_priv_dict(), ff_load_image(), ff_metadata_conv(), ff_parse_mpeg2_descriptor(), ff_read_riff_info(), ff_resman_get_string(), ff_rm_read_mdpr_codecdata(), ff_rtp_chain_mux_open(), ff_sauce_read(), ff_tadd_string_metadata(), ff_tee_parse_slave_options(), ff_tls_open_underlying(), ff_wms_parse_sdp_a_line(), ffio_copy_url_options(), ffurl_connect(), ffurl_open_whitelist(), filter(), filter_codec_opts(), filter_frame(), flac_init(), flac_read_header(), get_attachment(), get_meta(), get_metadata(), get_string(), get_tag(), gif_read_header(), h264_export_frame_props(), has_link_pair(), heif_add_stream(), hls_delete_file(), hls_mux_init(), hls_read_header(), hls_start(), hls_write_packet(), hls_write_trailer(), http_open_cnx_internal(), ice_dtls_handshake(), icecast_open(), id3v2_3_metadata_split_date(), iff_read_header(), ifile_open(), imf_read_header(), init_filter_graph(), init_muxer(), ism_seek(), ism_write_header(), ist_add(), ist_use(), lavfi_read_header(), LLVMFuzzerTestOneInput(), lrc_write_header(), main(), map_to_opts(), mcc_read_header(), merge_date(), mix_presentation_obu(), modplug_load_metadata(), mov_metadata_gnre(), mov_metadata_loci(), mov_metadata_track_or_disc_number(), mov_parse_stsd_audio(), mov_parse_stsd_data(), mov_parse_stsd_video(), mov_parse_tiles(), mov_read_custom(), mov_read_ftyp(), mov_read_hdlr(), mov_read_header(), mov_read_mdhd(), mov_read_rtmd_track(), mov_read_udta_string(), mov_read_uuid(), move_metadata(), mp3_parse_info_tag(), mpeg_decode_frame(), mxf_add_metadata_stream(), mxf_add_timecode_metadata(), mxf_add_umid_metadata(), mxf_parse_package_comments(), mxf_parse_physical_source_package(), mxf_parse_structural_metadata(), mxf_read_partition_pack(), nist_read_header(), nsp_read_header(), nsv_parse_NSVf_header(), of_add_attachments(), of_add_metadata(), of_add_programs(), of_parse_group_token(), of_parse_iamf_submixes(), offset_fn(), ofilter_bind_enc(), ogm_chapter(), open_codec_context(), open_input(), open_input_file(), open_slave(), open_url(), opencl_device_derive(), opt_bitrate(), opt_default(), opt_profile(), opt_show_entries(), opt_streamid(), opt_timecode(), ost_add(), output_frame(), parse_chunks(), parse_cookie(), parse_dsd_prop(), parse_icy(), parse_key_value_pair(), parse_playlist(), parse_programinformation(), parse_set_cookie(), parse_tag(), parse_timecode_in_framenum_format(), populate_avctx_color_fields(), print_filtergraph_single(), qsv_device_create(), r3d_read_red1(), read_comment(), read_gab2_sub(), read_header(), read_info_chunk(), read_string(), read_tag(), read_thread(), read_ttag(), read_uslt(), redirect_cache_set(), remove_avoptions(), reopen_demux_for_component(), rm_read_metadata(), rpl_read_header(), rtmp_open(), run_test(), run_transcription(), sap_write_header(), scan_file(), sdt_cb(), seg_init(), segment_end(), segment_start(), select_frame(), sender_thread(), set_colorquant_ratio_meta(), set_encoder_id(), set_http_options(), set_language(), set_meta(), set_metadata_float(), set_side_data(), smjpeg_read_header(), sox_read_header(), str_to_dict(), stream_component_open(), subviewer_read_header(), try_decode_frame(), update_metadata(), var_read_metadata(), decklink_input_callback::VideoInputFrameArrived(), vivo_read_header(), vorbis_parse_single_comment(), wc3_read_header(), webm_chunk_init(), and wsd_read_header().

av_dict_set_int()

int av_dict_set_int ( AVDictionary **  pm,
const char *  key,
int64_t  value,
int  flags 
)

Convenience wrapper for av_dict_set() that converts the value to a string and stores it.

Note: If AV_DICT_DONT_STRDUP_KEY is set, key will be freed on error.

Definition at line 177 of file dict.c.

Referenced by add_stream_to_programs(), copy_tls_opts_dict(), create_rtp_muxer(), dash_init(), dash_read_header(), dispose_session(), exchange_sdp(), ff_tls_open_underlying(), filter_frame(), ftp_connect_control_connection(), ftp_connect_data_connection(), hls_read_header(), http_listen(), ice_dtls_handshake(), ifile_open(), ism_write_header(), ist_add(), LLVMFuzzerTestOneInput(), main(), map_to_opts(), mov_metadata_int8_bypass_padding(), mov_metadata_int8_no_padding(), mov_read_ftyp(), mxf_parse_structural_metadata(), of_map_group(), of_open(), open_file(), open_input(), parse_tag(), prompeg_open(), read_header(), read_header_openmpt(), read_uint16(), read_uint32(), read_uint64(), read_uint8(), rtp_open(), rtsp_read_setup(), scd_read_track(), set_http_options(), set_metadata_int(), stream_component_open(), udp_connect(), vqf_read_header(), and webm_chunk_init().

av_dict_parse_string()

int av_dict_parse_string ( AVDictionary **  pm,
const char *  str,
const char *  key_val_sep,
const char *  pairs_sep,
int  flags 
)

Parse the key/value pairs list and add the parsed entries to a dictionary.

In case of failure, all the successfully set entries are stored in *pm. You may need to manually free the created dictionary.

Parameters
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
flags Flags to use when adding to the dictionary. AV_DICT_DONT_STRDUP_KEY and AV_DICT_DONT_STRDUP_VAL are ignored since the key/value tokens will always be duplicated.
Returns
0 on success, negative AVERROR code on failure

Definition at line 210 of file dict.c.

Referenced by av_opt_is_set_to_default(), avtext_context_open(), concat_parse_script(), delimited_dict_parse(), hw_device_init_from_string(), init(), libkvazaar_init(), main(), of_add_programs(), of_map_group(), of_parse_group_token(), of_parse_iamf_audio_element_layers(), of_parse_iamf_submixes(), parse_slave_fifo_options(), rtp_open(), run_test(), set_string_dict(), and test_separators().

av_dict_copy()

int av_dict_copy ( AVDictionary **  dst,
const AVDictionarysrc,
int  flags 
)

Copy entries from one AVDictionary struct into another.

Note
Metadata is read using the AV_DICT_IGNORE_SUFFIX flag
Parameters
dst Pointer to a pointer to a AVDictionary struct to copy into. If *dst is NULL, this function will allocate a struct for you and put it in *dst
src Pointer to the source AVDictionary struct to copy items from.
flags Flags to use when setting entries in *dst
Returns
0 on success, negative AVERROR code on failure. If dst was allocated by this function, callers should free the associated memory.

Definition at line 247 of file dict.c.

Referenced by asf_read_header(), av_frame_side_data_clone(), av_opt_get_dict_val(), av_opt_set_dict_val(), avformat_open_input(), copy_chapters(), copy_meta(), copy_metadata(), copy_stream_props(), dash_init(), dec_create(), ff_id3v2_parse_chapters(), ff_wms_parse_sdp_a_line(), fifo_mux_init(), fifo_thread_write_header(), frame_copy_props(), handle_id3(), hls_mux_init(), hls_read_header(), hls_read_packet(), http_open(), http_open_cnx(), init_muxer(), init_subtitle_context(), list_devices_for_context(), mark_section_show_entries(), of_open(), of_parse_group_token(), ofilter_bind_enc(), ogg_init(), open_audio(), open_file(), open_slave(), open_track_resource_context(), open_url(), open_video(), opt_copy_elem(), opt_default_new(), opt_target(), parse_assetmap(), parse_manifest(), parse_playlist(), read_frame_internal(), rtp_mpegts_write_header(), seg_init(), segment_mux_init(), segment_start(), set_http_options(), set_stream_info_from_input_stream(), stream_params_copy(), tee_write_header(), test_separators(), webm_chunk_init(), and write_packet().

av_dict_free()

void av_dict_free ( AVDictionary **  m )

Free all the memory allocated for an AVDictionary struct and all keys and values.

Definition at line 233 of file dict.c.

Referenced by add_filename_as_pkt_side_data(), asf_read_close(), av_frame_replace(), av_frame_side_data_clone(), av_frame_unref(), av_opt_is_set_to_default(), av_opt_set_dict2(), av_opt_set_dict_val(), avfilter_init_str(), avformat_find_stream_info(), avformat_free_context(), avformat_open_input(), avtext_context_open(), chunk_end(), clear_frame_metadata(), close_slave(), concat_read_close(), config_input(), config_props(), create_master_playlist(), create_rtp_muxer(), dash_close(), dash_free(), dash_init(), dash_write_packet(), dashenc_delete_file(), dec_enc(), dec_free(), decode_header(), delimited_dict_parse(), dispose_session(), do_encrypt(), ds_free(), dynamic_set_parameter(), exchange_sdp(), ff_free_stream(), ff_free_stream_group(), ff_http_do_new_request2(), ff_load_image(), ff_metadata_conv(), ff_resman_uninit(), ff_rtp_chain_mux_open(), ff_tee_parse_slave_options(), ff_url_read_all(), ff_vorbis_update_metadata(), ff_wms_parse_sdp_a_line(), fg_free(), fifo_thread_write_header(), filter_codec_opts(), filter_frame(), filter_params_free(), free_chapter(), free_playlist_list(), free_side_data_entry(), ftp_connect_control_connection(), ftp_connect_data_connection(), get_cookies(), graph_opts_apply(), handle_id3(), hls_close(), hls_delete_file(), hls_encryption_start(), hls_init_file_resend(), hls_mux_init(), hls_read_header(), hls_start(), hls_window(), hls_write_packet(), hls_write_trailer(), http_close(), http_listen(), http_open(), http_read_header(), http_seek_internal(), hw_device_init_from_string(), ice_dtls_handshake(), icecast_open(), id3v2_3_metadata_split_date(), ifile_open(), imf_close(), init(), init_filter_graph(), init_fps(), init_muxer(), init_subtitle_context(), ism_seek(), ism_write_header(), ist_free(), lavfi_read_header(), libkvazaar_init(), list_devices_for_context(), LLVMFuzzerTestOneInput(), main(), mermaid_uninit(), of_add_programs(), of_free(), of_open(), of_parse_group_token(), of_parse_iamf_audio_element_layers(), of_parse_iamf_submixes(), open_audio(), open_codec_context(), open_file(), open_input(), open_input_file(), open_slave(), open_track_resource_context(), open_url(), open_video(), opencl_device_derive(), opt_copy_elem(), opt_default_new(), opt_free_elem(), opt_show_entries(), ost_add(), parse_assetmap(), parse_cookie(), parse_features(), parse_manifest(), parse_models(), parse_playlist(), png_dec_end(), print_filtergraph_single(), prompeg_open(), qsv_device_create(), read_frame_internal(), read_thread(), reopen_demux_for_component(), replace_side_data_from_buf(), rtp_mpegts_write_header(), rtp_open(), rtsp_read_setup(), run_test(), seg_init(), segment_start(), set_string_dict(), setup_find_stream_info_opts(), show_packet(), stream_component_open(), stream_params_copy(), tee_open(), test_separators(), try_decode_frame(), udp_connect(), uninit_options(), uninit_opts(), uninit_parse_context(), decklink_input_callback::VideoInputFrameArrived(), webm_chunk_init(), write_hls_media_playlist(), write_manifest(), and write_packet().

av_dict_get_string()

int av_dict_get_string ( const AVDictionarym,
char **  buffer,
const char  key_val_sep,
const char  pairs_sep 
)

Get dictionary entries as a string.

Create a string containing dictionary's entries. Such string may be passed back to av_dict_parse_string().

Note
String is escaped with backslashes ('\').
Warning
Separators cannot be neither '\' nor '0円'. They also cannot be the same.
Parameters
[in] m The dictionary
[out] buffer Pointer to buffer that will be allocated with string containing entries. Buffer must be freed by the caller when is no longer needed.
[in] key_val_sep Character used to separate key from value
[in] pairs_sep Character used to separate two pairs from each other
Returns
>= 0 on success, negative on error

Definition at line 260 of file dict.c.

Referenced by configure_filtergraph(), dump_stream_meta(), main(), open_slave(), opt_get_elem(), and test_separators().

AVDictionary
Definition: dict.c:32
AV_DICT_DONT_STRDUP_VAL
#define AV_DICT_DONT_STRDUP_VAL
Take ownership of a value that's been allocated with av_malloc() or another memory allocation functio...
Definition: dict.h:79
NULL
#define NULL
Definition: coverity.c:32
av_dict_free
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
Definition: dict.c:233
av_strdup
char * av_strdup(const char *s)
Duplicate a string.
Definition: mem.c:272
AVDictionaryEntry
Definition: dict.h:90
av_dict_set
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
Definition: dict.c:86
av_dict_iterate
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
Definition: dict.c:42
AV_DICT_DONT_STRDUP_KEY
#define AV_DICT_DONT_STRDUP_KEY
Take ownership of a key that's been allocated with av_malloc() or another memory allocation function.
Definition: dict.h:77

Generated on Fri Oct 17 2025 19:24:18 for FFmpeg by   doxygen 1.8.17

AltStyle によって変換されたページ (->オリジナル) /