Simple key:value store. More...
Files | |
file | attributes.h |
Macro definitions for various function/variable attributes. | |
Data Structures | |
struct | AVDictionaryEntry |
Macros | |
#define | AV_DICT_MATCH_CASE 1 |
#define | AV_DICT_IGNORE_SUFFIX 2 |
#define | AV_DICT_DONT_STRDUP_KEY 4 |
Take ownership of a key that's been allocated with av_malloc() and children. More... | |
#define | AV_DICT_DONT_STRDUP_VAL 8 |
Take ownership of a value that's been allocated with av_malloc() and chilren. 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... | |
Typedefs | |
typedef struct AVDictionaryEntry | AVDictionaryEntry |
typedef struct AVDictionary | AVDictionary |
Functions | |
AVDictionaryEntry * | av_dict_get (AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags) |
Get a dictionary entry with matching key. 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... | |
void | av_dict_copy (AVDictionary **dst, AVDictionary *src, int flags) |
Copy entries from one AVDictionary struct into another. More... | |
void | av_dict_free (AVDictionary **m) |
Free all the memory allocated for an AVDictionary struct and all keys and values. More... | |
Simple key:value store.
Dictionaries are used for storing key:value pairs. To create an AVDictionary, simply pass an address of a NULL pointer to av_dict_set(). NULL can be used as an empty dictionary wherever a pointer to an AVDictionary is required. Use av_dict_get() to retrieve an entry or iterate over all entries and finally av_dict_free() to free the dictionary and all its contents.
Simple key:value store
Dictionaries are used for storing key:value pairs. To create an AVDictionary, simply pass an address of a NULL pointer to av_dict_set(). NULL can be used as an empty dictionary wherever a pointer to an AVDictionary is required. Use av_dict_get() to retrieve an entry or iterate over all entries and finally av_dict_free() to free the dictionary and all its contents.
#define AV_DICT_APPEND 32 |
#define AV_DICT_DONT_OVERWRITE 16 |
#define AV_DICT_DONT_STRDUP_KEY 4 |
Take ownership of a key that's been allocated with av_malloc() and children.
#define AV_DICT_DONT_STRDUP_VAL 8 |
Take ownership of a value that's been allocated with av_malloc() and chilren.
typedef struct AVDictionary AVDictionary |
typedef struct AVDictionaryEntry AVDictionaryEntry |
void av_dict_copy | ( | AVDictionary ** | dst, |
AVDictionary * | src, | ||
int | flags | ||
) |
Copy entries from one AVDictionary struct into another.
dst | pointer to a pointer to a AVDictionary struct. If *dst is NULL, this function will allocate a struct for you and put it in *dst |
src | pointer to source AVDictionary struct |
flags | flags to use when setting entries in *dst |
Definition at line 127 of file dict.c.
Referenced by avcodec_open2(), avformat_open_input(), copy_chapters(), copy_metadata(), ff_wms_parse_sdp_a_line(), init_muxer(), and open_output_file().
int av_dict_count | ( | const AVDictionary * | m) |
Get number of entries in dictionary.
m | dictionary |
Definition at line 34 of file dict.c.
Referenced by asf_write_header1(), and dump_metadata().
void av_dict_free | ( | AVDictionary ** | m) |
Free all the memory allocated for an AVDictionary struct and all keys and values.
Definition at line 113 of file dict.c.
Referenced by av_opt_set_dict(), avcodec_open2(), avformat_find_stream_info(), avformat_free_context(), avformat_open_input(), close_connection(), decode_thread(), exit_program(), ff_metadata_conv(), ff_rtp_chain_mux_open(), ff_wms_parse_sdp_a_line(), http_prepare_data(), init_muxer(), ism_seek(), ism_write_header(), main(), open_input_file(), prepare_sdp_description(), rtmp_open(), transcode(), try_decode_frame(), uninit_opts(), and uninit_parse_context().
AVDictionaryEntry* av_dict_get | ( | AVDictionary * | m, |
const char * | key, | ||
const AVDictionaryEntry * | prev, | ||
int | flags | ||
) |
Get a dictionary entry with matching key.
prev | Set to the previous matching element to find the next. If set to NULL the first matching element is returned. |
flags | Allows case as well as suffix-insensitive comparisons. |
Definition at line 40 of file dict.c.
Referenced by asf_write_header1(), assert_avoptions(), av_dict_copy(), av_dict_set(), av_dump_format(), av_opt_set_dict(), avi_write_header(), bwf_write_bext_chunk(), bwf_write_bext_string(), decode_thread(), dump_attachment(), dump_metadata(), dump_stream_format(), dv_init_mux(), ff_id3v2_write_apic(), ff_id3v2_write_metadata(), ff_metadata_conv(), ff_vorbiscomment_length(), ff_vorbiscomment_write(), filter_codec_opts(), flv_write_header(), get_date_tag(), gxf_write_umf_material_description(), id3v1_create_tag(), id3v1_set_string(), init_input_stream(), main(), mkv_write_attachments(), mkv_write_chapters(), mkv_write_header(), mkv_write_tag(), mkv_write_tags(), mkv_write_tracks(), mov_write_3gp_udta_tag(), mov_write_chpl_tag(), mov_write_header(), mov_write_string_metadata(), mov_write_trkn_tag(), mov_write_uuidusmt_tag(), mp3_read_header(), mpc_read_header(), mpegts_write_header(), mpegts_write_pmt(), mxf_write_header(), open_input_file(), probe_dict(), rv10_write_header(), sap_write_header(), show_format_entry_integer(), show_format_entry_string(), smjpeg_write_header(), sox_write_header(), stream_component_open(), transcode_init(), tta_read_header(), write_chapter(), write_globalinfo(), write_tags(), and wv_read_header().
int av_dict_set | ( | AVDictionary ** | pm, |
const char * | key, | ||
const char * | value, | ||
int | flags | ||
) |
Set the given entry in *pm, overwriting an existing entry.
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 be av_strduped depending on flags) |
value | entry value to add to *pm (will be av_strduped depending on flags). Passing a NULL value will cause an existing entry to be deleted. |
Definition at line 63 of file dict.c.
Referenced by add_metadata(), amf_parse_object(), ape_tag_read_field(), asf_read_header(), asf_read_picture(), av_dict_copy(), av_opt_set_dict(), avformat_find_stream_info(), avi_metadata_creation_time(), avi_read_nikon(), avi_read_tag(), avpriv_new_chapter(), build_file_streams(), decode_info_header(), ff_id3v2_parse_apic(), ff_metadata_conv(), ff_parse_mpeg2_descriptor(), ff_rtp_chain_mux_open(), ff_sauce_read(), ff_vorbis_comment(), ff_wms_parse_sdp_a_line(), filter_codec_opts(), get_attachment(), get_meta(), get_metadata(), get_string(), get_tag(), hls_read_header(), http_prepare_data(), init_input_stream(), init_muxer(), ism_seek(), ism_write_header(), main(), matroska_convert_tag(), matroska_read_header(), merge_date(), mov_metadata_creation_time(), mov_metadata_gnre(), mov_metadata_int8_bypass_padding(), mov_metadata_int8_no_padding(), mov_metadata_track_or_disc_number(), mov_read_ftyp(), mov_read_mdhd(), mov_read_udta_string(), new_output_stream(), nsv_parse_NSVf_header(), ogm_chapter(), open_input_file(), open_output_file(), opt_default(), opt_show_format_entry(), parse_chunks(), parse_picture(), parse_tag(), prepare_sdp_description(), r3d_read_red1(), read_gab2_sub(), read_info_chunk(), read_tag(), read_ttag(), rm_read_metadata(), rpl_read_header(), rtmp_open(), sap_write_header(), sdt_cb(), smjpeg_read_header(), sox_read_header(), stream_component_open(), transcode_init(), try_decode_frame(), vqf_read_header(), and wc3_read_header().