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
	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.
#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
AVDictionaryEntry *	av_dict_get (AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
	Get a dictionary entry with matching key.
int	av_dict_count (const AVDictionary *m)
	Get number of entries in dictionary.
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 and all keys and values.

---

Detailed Description

Public dictionary API.

Deprecated:

AVDictionary is provided for compatibility with libav. It is both in implementation as well as API inefficient. It does not scale and is extremely slow with large dictionaries. It is recommended that new code uses our tree container from tree.c/h where applicable, which uses AVL trees to achieve O(log n) performance.

Definition in file dict.h.