FFmpeg中的内部数据类型

摘要：简要描述FFmpeg内部定义的数据类型和相关操作的API及其实现。关键字：AVDictionary,

1 `AVDictionary`及相关API

AVDictionary虽然名字里是有字典的单词，但是只是一个单纯的键值对数组。

typedef struct AVDictionaryEntry {
    char *key;
    char *value;
} AVDictionaryEntry;

struct AVDictionary {
    int count;
    AVDictionaryEntry *elems;
};

typedef struct AVDictionary AVDictionary;

相关API实现：

int av_dict_count(const AVDictionary *m)：实际上就是返回AVDictionary->count；
AVDictionaryEntry *av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)：从```prev``开始搜索下一个符合搜索要求的项，具体实现中是通过字符串一个一个比较实现的：
- m,key：搜索的对象和目标key；
- prev：开始搜索的位置；
- flags：搜索的flag，如果设置AV_DICT_MATCH_CASE则忽略大小写。如果设置AV_DICT_IGNORE_SUFFIX则忽略已经匹配好的字符串的后缀，比如format1能够匹配上format；
int av_dict_set(AVDictionary * *pm, const char *key, const char *value, int flags)：这个api准确的描述应该是av_dict_set_or_add也就是说能找到则尝试更改，否则添加新的项：
- flags：配置对key和value的内存管理，默认会复制对应的字符串，需要注意的是如果设置了类似AV_DICT_DONT_STRDUP_KEY也就是将外部申请的字符串的所有权交给了pm，内部在释放时会free的；
int av_dict_set_int(AVDictionary * *pm, const char *key, int64_t value, int flags)：实际上就是将value转换成string然后通过av_dict_set```设置；
int av_dict_parse_string(AVDictionary * *pm, const char *str, const char *key_val_sep, const char *pairs_sep, int flags)：根据字符串str解析键值对创建AVDictoionary：
- str：一个以key_val_sep作为键值对内的分隔符，pairs_sep作为键值对间分隔符的字符串，比如rate=1000;fmt=1;width=100；
- key_val_sep：键值对内部的分隔符，对于上面字符串即=；
- pairs_sep：键值对间的分隔符，对于上面的字符串为;；
- flags：控制生成字典的标志符；
void av_dict_free(AVDictionary * *pm)：释放字典，是通过FFmpeg内的释放函数释放的也就是说申请的内存最好也是通过FFmpeg内部的函数进行处理不然可能出现无法对齐而释放不正确的问题；
int av_dict_copy(AVDictionary * *dst, const AVDictionary *src, int flags)：不断av_dict_get然后av_dict_set：
int av_dict_get_string(const AVDictionary *m, char * *buffer, const char key_val_sep, const char pairs_sep)：将字典解析为字符串，和av_dict_parse_string互为逆操作；
int avpriv_dict_set_timestamp(AVDictionary * *dict, const char *key, int64_t timestamp)：将timestamp格式化为字符串设置。

2 `AVRational`及相关API

FFmpeg中由于部分浮点小数运算是高精度的，如果采用float,double来存储的话多次运算之后无法避免的会产生精度误差从而影响输出的结果。因此FFmpeg采用小数的分数形式来表示对应的小数，直到最后需要使用float,double的时候再将其转换成对应的形式能尽可能的降低精度损失。下面是FFmpeg中小数表示的定义形式：

typedef struct AVRational{
    int num; ///< Numerator
    int den; ///< Denominator
} AVRational;

FFmpeg中的内部数据类型

1 AVDictionary及相关API

2 AVRational及相关API

1 `AVDictionary`及相关API

2 `AVRational`及相关API