libavutil/dict.c File Reference

#include <strings.h>
#include "avstring.h"
#include "dict.h"
#include "internal.h"
#include "mem.h"

Go to the source code of this file.

Functions
AVDictionaryEntry *	av_dict_get (AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
	Get a dictionary entry with matching key.
int	av_dict_set (AVDictionary **pm, const char *key, const char *value, int flags)
	Set the given entry in *pm, overwriting an existing entry.
void	av_dict_free (AVDictionary **pm)
	Free all the memory allocated for an AVDictionary struct.
void	av_dict_copy (AVDictionary **dst, AVDictionary *src, int flags)
	Copy entries from one AVDictionary struct into another.

---

Function Documentation

void av_dict_copy	(	AVDictionary **	dst,
		AVDictionary *	src,
		int	flags
	)

Copy entries from one AVDictionary struct into another.

Parameters:

	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

Note:

metadata is read using the AV_DICT_IGNORE_SUFFIX flag

Definition at line 115 of file dict.c.

Referenced by av_metadata_copy(), avcodec_open2(), avformat_open_input(), avformat_write_header(), copy_chapters(), ff_wms_parse_sdp_a_line(), opt_output_file(), and transcode().

void av_dict_free

(

AVDictionary **

pm

)

Free all the memory allocated for an AVDictionary struct.

Definition at line 101 of file dict.c.

Referenced by av_metadata_free(), av_open_input_file(), av_open_input_stream(), av_opt_set_dict(), avcodec_open2(), avformat_free_context(), avformat_open_input(), avformat_write_header(), close_connection(), ff_metadata_conv(), http_prepare_data(), opt_output_file(), prepare_sdp_description(), and uninit_opts().

AVDictionaryEntry* av_dict_get	(	AVDictionary *	m,
		const char *	key,
		const AVDictionaryEntry *	prev,
		int	flags
	)

Get a dictionary entry with matching key.

Parameters:

	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.

Returns:

Found entry or NULL, changing key or value leads to undefined behavior.

Definition at line 28 of file dict.c.

Referenced by asf_write_header1(), av_dict_copy(), av_dict_set(), av_dump_format(), av_metadata_get(), av_opt_set_dict(), avi_write_header(), dump_metadata(), dump_stream_format(), ff_metadata_conv(), ff_vorbiscomment_length(), ff_vorbiscomment_write(), flv_write_header(), get_date_tag(), id3v1_create_tag(), id3v1_set_string(), main(), 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(), open_input_file(), read_thread(), rv10_write_header(), show_format(), show_stream(), sox_write_header(), 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.

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 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 tag to be deleted.

Returns:

>= 0 on success otherwise an error code <0

Definition at line 51 of file dict.c.

Referenced by add_metadata(), amf_parse_object(), ape_tag_read_field(), applehttp_read_header(), asf_read_header(), av_dict_copy(), av_metadata_set2(), av_opt_set_dict(), avformat_write_header(), avi_metadata_creation_time(), avi_read_nikon(), avi_read_tag(), build_file_streams(), convert_format_parameters(), decode_info_header(), ff_metadata_conv(), ff_new_chapter(), ff_parse_mpeg2_descriptor(), ff_sauce_read(), ff_vorbis_comment(), get_attachment(), get_meta(), get_metadata(), get_string(), get_tag(), http_prepare_data(), matroska_convert_tag(), matroska_read_header(), merge_date(), mov_metadata_creation_time(), mov_metadata_track_or_disc_number(), mov_read_ftyp(), mov_read_mdhd(), mov_read_tkhd(), mov_read_udta_string(), new_audio_stream(), new_subtitle_stream(), new_video_stream(), nsv_parse_NSVf_header(), ogm_chapter(), opt_default2(), opt_metadata(), parse_chunks(), parse_tag(), prepare_sdp_description(), r3d_read_red1(), read_gab2_sub(), read_info_chunk(), read_tag(), read_ttag(), rm_read_metadata(), rpl_read_header(), sdt_cb(), sox_read_header(), and wc3_read_header().