FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavutil/dict.c
Date: 2026-07-18 19:31:15
Exec Total Coverage
Lines: 146 156 93.6%
Functions: 10 10 100.0%
Branches: 106 132 80.3%

Line Branch Exec Source
1 /*
2 * copyright (c) 2009 Michael Niedermayer
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include <inttypes.h>
22 #include <stdio.h>
23 #include <string.h>
24
25 #include "avassert.h"
26 #include "avstring.h"
27 #include "dict.h"
28 #include "error.h"
29 #include "mem.h"
30 #include "bprint.h"
31
32 struct AVDictionary {
33 int count;
34 AVDictionaryEntry *elems;
35 };
36
37 32460 int av_dict_count(const AVDictionary *m)
38 {
39
2/2
✓ Branch 0 taken 22802 times.
✓ Branch 1 taken 9658 times.
32460 return m ? m->count : 0;
40 }
41
42 6068956 const AVDictionaryEntry *av_dict_iterate(const AVDictionary *m,
43 const AVDictionaryEntry *prev)
44 {
45 6068956 int i = 0;
46
47
2/2
✓ Branch 0 taken 2874498 times.
✓ Branch 1 taken 3194458 times.
6068956 if (!m)
48 2874498 return NULL;
49
50
2/2
✓ Branch 0 taken 2031578 times.
✓ Branch 1 taken 1162880 times.
3194458 if (prev)
51 2031578 i = prev - m->elems + 1;
52
53 av_assert2(i >= 0);
54
2/2
✓ Branch 0 taken 891463 times.
✓ Branch 1 taken 2302995 times.
3194458 if (i >= m->count)
55 891463 return NULL;
56
57 2302995 return &m->elems[i];
58 }
59
60 2063917 AVDictionaryEntry *av_dict_get(const AVDictionary *m, const char *key,
61 const AVDictionaryEntry *prev, int flags)
62 {
63 2063917 const AVDictionaryEntry *entry = prev;
64 unsigned int j;
65
66
2/2
✓ Branch 0 taken 1 times.
✓ Branch 1 taken 2063916 times.
2063917 if (!key)
67 1 return NULL;
68
69
2/2
✓ Branch 1 taken 1829313 times.
✓ Branch 2 taken 1792272 times.
3621585 while ((entry = av_dict_iterate(m, entry))) {
70 1829313 const char *s = entry->key;
71
2/2
✓ Branch 0 taken 222713 times.
✓ Branch 1 taken 1606600 times.
1829313 if (flags & AV_DICT_MATCH_CASE)
72
4/4
✓ Branch 0 taken 266205 times.
✓ Branch 1 taken 212302 times.
✓ Branch 2 taken 255794 times.
✓ Branch 3 taken 10411 times.
478507 for (j = 0; s[j] == key[j] && key[j]; j++)
73 ;
74 else
75
4/4
✓ Branch 0 taken 6826596 times.
✓ Branch 1 taken 1345595 times.
✓ Branch 2 taken 6565591 times.
✓ Branch 3 taken 261005 times.
8172191 for (j = 0; av_toupper(s[j]) == av_toupper(key[j]) && key[j]; j++)
76 ;
77
2/2
✓ Branch 0 taken 1552913 times.
✓ Branch 1 taken 276400 times.
1829313 if (key[j])
78 1552913 continue;
79
4/4
✓ Branch 0 taken 4984 times.
✓ Branch 1 taken 271416 times.
✓ Branch 2 taken 4756 times.
✓ Branch 3 taken 228 times.
276400 if (s[j] && !(flags & AV_DICT_IGNORE_SUFFIX))
80 4756 continue;
81 271644 return (AVDictionaryEntry *)entry;
82 }
83 1792272 return NULL;
84 }
85
86 1372826 int av_dict_set(AVDictionary **pm, const char *key, const char *value,
87 int flags)
88 {
89 1372826 AVDictionary *m = *pm;
90 1372826 AVDictionaryEntry *tag = NULL;
91 1372826 char *copy_key = NULL, *copy_value = NULL;
92 int err;
93
94
2/2
✓ Branch 0 taken 64675 times.
✓ Branch 1 taken 1308151 times.
1372826 if (flags & AV_DICT_DONT_STRDUP_VAL)
95 64675 copy_value = (void *)value;
96
2/2
✓ Branch 0 taken 539625 times.
✓ Branch 1 taken 768526 times.
1308151 else if (value)
97 539625 copy_value = av_strdup(value);
98
2/2
✓ Branch 0 taken 4 times.
✓ Branch 1 taken 1372822 times.
1372826 if (!key) {
99 4 err = AVERROR(EINVAL);
100 4 goto err_out;
101 }
102
2/2
✓ Branch 0 taken 33716 times.
✓ Branch 1 taken 1339106 times.
1372822 if (flags & AV_DICT_DONT_STRDUP_KEY)
103 33716 copy_key = (void *)key;
104 else
105 1339106 copy_key = av_strdup(key);
106
4/6
✓ Branch 0 taken 1372822 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 604295 times.
✓ Branch 3 taken 768527 times.
✗ Branch 4 not taken.
✓ Branch 5 taken 604295 times.
1372822 if (!copy_key || (value && !copy_value))
107 goto enomem;
108
109
2/2
✓ Branch 0 taken 1260740 times.
✓ Branch 1 taken 112082 times.
1372822 if (!(flags & AV_DICT_MULTIKEY)) {
110 1260740 tag = av_dict_get(m, key, NULL, flags);
111
2/2
✓ Branch 0 taken 7382 times.
✓ Branch 1 taken 104700 times.
112082 } else if (flags & AV_DICT_DEDUP) {
112
2/2
✓ Branch 1 taken 15 times.
✓ Branch 2 taken 7369 times.
7384 while ((tag = av_dict_get(m, key, tag, flags))) {
113
2/6
✗ Branch 0 not taken.
✓ Branch 1 taken 15 times.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
✓ Branch 4 taken 15 times.
✗ Branch 5 not taken.
15 if ((!value && !tag->value) ||
114
3/4
✓ Branch 0 taken 15 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 13 times.
✓ Branch 3 taken 2 times.
15 (value && tag->value && !strcmp(value, tag->value))) {
115 13 av_free(copy_key);
116 13 av_free(copy_value);
117 13 return 0;
118 }
119 }
120 }
121
2/2
✓ Branch 0 taken 784466 times.
✓ Branch 1 taken 588343 times.
1372809 if (!m)
122 784466 m = *pm = av_mallocz(sizeof(*m));
123
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1372809 times.
1372809 if (!m)
124 goto enomem;
125
126
2/2
✓ Branch 0 taken 180031 times.
✓ Branch 1 taken 1192778 times.
1372809 if (tag) {
127
2/2
✓ Branch 0 taken 817 times.
✓ Branch 1 taken 179214 times.
180031 if (flags & AV_DICT_DONT_OVERWRITE) {
128 817 av_free(copy_key);
129 817 av_free(copy_value);
130 817 return 0;
131 }
132
4/4
✓ Branch 0 taken 38004 times.
✓ Branch 1 taken 141210 times.
✓ Branch 2 taken 16389 times.
✓ Branch 3 taken 21615 times.
179214 if (copy_value && flags & AV_DICT_APPEND) {
133 16389 size_t oldlen = strlen(tag->value);
134 16389 size_t new_part_len = strlen(copy_value);
135 16389 size_t len = oldlen + new_part_len + 1;
136 16389 char *newval = av_realloc(tag->value, len);
137
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 16389 times.
16389 if (!newval)
138 goto enomem;
139 16389 memcpy(newval + oldlen, copy_value, new_part_len + 1);
140 16389 av_freep(&copy_value);
141 16389 copy_value = newval;
142 } else
143 162825 av_free(tag->value);
144 179214 av_free(tag->key);
145 179214 *tag = m->elems[--m->count];
146
2/2
✓ Branch 0 taken 565461 times.
✓ Branch 1 taken 627317 times.
1192778 } else if (copy_value) {
147 565461 AVDictionaryEntry *tmp = av_realloc_array(m->elems,
148 565461 m->count + 1, sizeof(*m->elems));
149
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 565461 times.
565461 if (!tmp)
150 goto enomem;
151 565461 m->elems = tmp;
152 }
153
2/2
✓ Branch 0 taken 603465 times.
✓ Branch 1 taken 768527 times.
1371992 if (copy_value) {
154 603465 m->elems[m->count].key = copy_key;
155 603465 m->elems[m->count].value = copy_value;
156 603465 m->count++;
157 } else {
158 768527 err = 0;
159 768527 goto end;
160 }
161
162 603465 return 0;
163
164 enomem:
165 err = AVERROR(ENOMEM);
166 4 err_out:
167 4 av_free(copy_value);
168 768531 end:
169
4/4
✓ Branch 0 taken 768527 times.
✓ Branch 1 taken 4 times.
✓ Branch 2 taken 582073 times.
✓ Branch 3 taken 186454 times.
768531 if (m && !m->count) {
170 582073 av_freep(&m->elems);
171 582073 av_freep(pm);
172 }
173 768531 av_free(copy_key);
174 768531 return err;
175 }
176
177 9485 int av_dict_set_int(AVDictionary **pm, const char *key, int64_t value,
178 int flags)
179 {
180 char valuestr[22];
181 9485 snprintf(valuestr, sizeof(valuestr), "%"PRId64, value);
182 9485 flags &= ~AV_DICT_DONT_STRDUP_VAL;
183 9485 return av_dict_set(pm, key, valuestr, flags);
184 }
185
186 558 static int parse_key_value_pair(AVDictionary **pm, const char **buf,
187 const char *key_val_sep, const char *pairs_sep,
188 int flags)
189 {
190 558 char *key = av_get_token(buf, key_val_sep);
191 558 char *val = NULL;
192 int ret;
193
194
3/6
✓ Branch 0 taken 558 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 558 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 558 times.
✗ Branch 5 not taken.
558 if (key && *key && strspn(*buf, key_val_sep)) {
195 558 (*buf)++;
196 558 val = av_get_token(buf, pairs_sep);
197 }
198
199
4/8
✓ Branch 0 taken 558 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 558 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 558 times.
✗ Branch 5 not taken.
✓ Branch 6 taken 558 times.
✗ Branch 7 not taken.
558 if (key && *key && val && *val)
200 558 ret = av_dict_set(pm, key, val, flags);
201 else
202 ret = AVERROR(EINVAL);
203
204 558 av_freep(&key);
205 558 av_freep(&val);
206
207 558 return ret;
208 }
209
210 275 int av_dict_parse_string(AVDictionary **pm, const char *str,
211 const char *key_val_sep, const char *pairs_sep,
212 int flags)
213 {
214 int ret;
215
216
2/2
✓ Branch 0 taken 7 times.
✓ Branch 1 taken 268 times.
275 if (!str)
217 7 return 0;
218
219 /* ignore STRDUP flags */
220 268 flags &= ~(AV_DICT_DONT_STRDUP_KEY | AV_DICT_DONT_STRDUP_VAL);
221
222
2/2
✓ Branch 0 taken 558 times.
✓ Branch 1 taken 268 times.
1094 while (*str) {
223
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 558 times.
558 if ((ret = parse_key_value_pair(pm, &str, key_val_sep, pairs_sep, flags)) < 0)
224 return ret;
225
226
2/2
✓ Branch 0 taken 266 times.
✓ Branch 1 taken 292 times.
558 if (*str)
227 292 str++;
228 }
229
230 268 return 0;
231 }
232
233 9315570 void av_dict_free(AVDictionary **pm)
234 {
235 9315570 AVDictionary *m = *pm;
236
237
2/2
✓ Branch 0 taken 202393 times.
✓ Branch 1 taken 9113177 times.
9315570 if (m) {
238
2/2
✓ Branch 0 taken 424251 times.
✓ Branch 1 taken 202393 times.
626644 while (m->count--) {
239 424251 av_freep(&m->elems[m->count].key);
240 424251 av_freep(&m->elems[m->count].value);
241 }
242 202393 av_freep(&m->elems);
243 }
244 9315570 av_freep(pm);
245 9315570 }
246
247 1564673 int av_dict_copy(AVDictionary **dst, const AVDictionary *src, int flags)
248 {
249 1564673 const AVDictionaryEntry *t = NULL;
250
251
2/2
✓ Branch 1 taken 59915 times.
✓ Branch 2 taken 1564673 times.
1624588 while ((t = av_dict_iterate(src, t))) {
252 59915 int ret = av_dict_set(dst, t->key, t->value, flags);
253
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 59915 times.
59915 if (ret < 0)
254 return ret;
255 }
256
257 1564673 return 0;
258 }
259
260 4621 int av_dict_get_string(const AVDictionary *m, char **buffer,
261 const char key_val_sep, const char pairs_sep)
262 {
263 4621 const AVDictionaryEntry *t = NULL;
264 AVBPrint bprint;
265 4621 int cnt = 0;
266 4621 char special_chars[] = {pairs_sep, key_val_sep, '\0'};
267
268
4/8
✓ Branch 0 taken 4621 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 4621 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 4621 times.
✗ Branch 5 not taken.
✓ Branch 6 taken 4621 times.
✗ Branch 7 not taken.
4621 if (!buffer || pairs_sep == '\0' || key_val_sep == '\0' || pairs_sep == key_val_sep ||
269
2/4
✓ Branch 0 taken 4621 times.
✗ Branch 1 not taken.
✗ Branch 2 not taken.
✓ Branch 3 taken 4621 times.
4621 pairs_sep == '\\' || key_val_sep == '\\')
270 return AVERROR(EINVAL);
271
272
2/2
✓ Branch 1 taken 41 times.
✓ Branch 2 taken 4580 times.
4621 if (!av_dict_count(m)) {
273 41 *buffer = av_strdup("");
274
1/2
✓ Branch 0 taken 41 times.
✗ Branch 1 not taken.
41 return *buffer ? 0 : AVERROR(ENOMEM);
275 }
276
277 4580 av_bprint_init(&bprint, 64, AV_BPRINT_SIZE_UNLIMITED);
278
2/2
✓ Branch 1 taken 4634 times.
✓ Branch 2 taken 4580 times.
9214 while ((t = av_dict_iterate(m, t))) {
279
2/2
✓ Branch 0 taken 54 times.
✓ Branch 1 taken 4580 times.
4634 if (cnt++)
280 54 av_bprint_append_data(&bprint, &pairs_sep, 1);
281 4634 av_bprint_escape(&bprint, t->key, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
282 4634 av_bprint_append_data(&bprint, &key_val_sep, 1);
283 4634 av_bprint_escape(&bprint, t->value, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
284 }
285 4580 return av_bprint_finalize(&bprint, buffer);
286 }
287