libavutil/dict.h File Reference

Public dictionary API. More...

Go to the source code of this file.

Data Structures

struct  AVDictionaryEntry

Defines

#define AV_DICT_MATCH_CASE   1
#define AV_DICT_IGNORE_SUFFIX   2
#define AV_DICT_DONT_STRDUP_KEY   4
#define AV_DICT_DONT_STRDUP_VAL   8
#define AV_DICT_DONT_OVERWRITE   16
 Don't overwrite existing entries.
#define AV_DICT_APPEND   32
 If the entry already exists, append to it.

Typedefs

typedef struct AVDictionary AVDictionary

Functions

AVDictionaryEntryav_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_copy (AVDictionary **dst, AVDictionary *src, int flags)
 Copy entries from one AVDictionary struct into another.
void av_dict_free (AVDictionary **m)
 Free all the memory allocated for an AVDictionary struct.


Detailed Description

Public dictionary API.

Definition in file dict.h.


Define Documentation

#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 33 of file dict.h.

Referenced by av_dict_set().

#define AV_DICT_DONT_OVERWRITE   16

Don't overwrite existing entries.

Definition at line 32 of file dict.h.

Referenced by av_dict_set(), read_ttag(), and transcode().

#define AV_DICT_DONT_STRDUP_KEY   4

Definition at line 30 of file dict.h.

Referenced by av_dict_set(), ff_vorbis_comment(), and read_tag().

#define AV_DICT_DONT_STRDUP_VAL   8

#define AV_DICT_IGNORE_SUFFIX   2

#define AV_DICT_MATCH_CASE   1

Definition at line 28 of file dict.h.

Referenced by av_dict_get(), and get_date_tag().


Typedef Documentation

typedef struct AVDictionary AVDictionary

Definition at line 41 of file dict.h.


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 **  m  ) 

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

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().


Generated on Fri Oct 26 02:38:21 2012 for FFmpeg by  doxygen 1.5.8