Mercurial > libavutil.hg
annotate avstring.h @ 867:9b3647b95b14 libavutil
Merge two adjacent ifdef blocks
author | mru |
---|---|
date | Mon, 08 Mar 2010 21:28:58 +0000 |
parents | 536c2e94defa |
children | c66e06fb1b36 |
rev | line source |
---|---|
347 | 1 /* |
2 * Copyright (c) 2007 Mans Rullgard | |
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 | |
567 | 21 #ifndef AVUTIL_AVSTRING_H |
22 #define AVUTIL_AVSTRING_H | |
347 | 23 |
24 #include <stddef.h> | |
25 | |
26 /** | |
27 * Return non-zero if pfx is a prefix of str. If it is, *ptr is set to | |
28 * the address of the first character in str after the prefix. | |
29 * | |
30 * @param str input string | |
31 * @param pfx prefix to test | |
637 | 32 * @param ptr updated if the prefix is matched inside str |
347 | 33 * @return non-zero if the prefix matches, zero otherwise |
34 */ | |
35 int av_strstart(const char *str, const char *pfx, const char **ptr); | |
36 | |
37 /** | |
38 * Return non-zero if pfx is a prefix of str independent of case. If | |
39 * it is, *ptr is set to the address of the first character in str | |
40 * after the prefix. | |
41 * | |
42 * @param str input string | |
43 * @param pfx prefix to test | |
637 | 44 * @param ptr updated if the prefix is matched inside str |
347 | 45 * @return non-zero if the prefix matches, zero otherwise |
46 */ | |
47 int av_stristart(const char *str, const char *pfx, const char **ptr); | |
48 | |
49 /** | |
860 | 50 * Locate the first case-independent occurrence in the string s1 of |
51 * the string s2. A zero-length string s2 is considered to match at | |
52 * the start of s1. | |
53 * | |
54 * This function is a case-insensitive version of the standard strstr(). | |
55 * | |
56 * @param s1 string to search in | |
57 * @param s2 string to search for | |
58 * @return pointer to the located match within s1 or a null pointer if no match | |
59 */ | |
60 char *av_stristr(const char *s1, const char *s2); | |
61 | |
62 /** | |
347 | 63 * Copy the string src to dst, but no more than size - 1 bytes, and |
633 | 64 * null-terminate dst. |
347 | 65 * |
66 * This function is the same as BSD strlcpy(). | |
67 * | |
68 * @param dst destination buffer | |
69 * @param src source string | |
70 * @param size size of destination buffer | |
71 * @return the length of src | |
778
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
72 * |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
73 * WARNING: since the return value is the length of src, src absolutely |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
74 * _must_ be a properly 0-terminated string, otherwise this will read beyond |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
75 * the end of the buffer and possibly crash. |
347 | 76 */ |
77 size_t av_strlcpy(char *dst, const char *src, size_t size); | |
78 | |
79 /** | |
80 * Append the string src to the string dst, but to a total length of | |
633 | 81 * no more than size - 1 bytes, and null-terminate dst. |
347 | 82 * |
83 * This function is similar to BSD strlcat(), but differs when | |
84 * size <= strlen(dst). | |
85 * | |
86 * @param dst destination buffer | |
87 * @param src source string | |
88 * @param size size of destination buffer | |
89 * @return the total length of src and dst | |
778
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
90 * |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
91 * WARNING: since the return value use the length of src and dst, these absolutely |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
92 * _must_ be a properly 0-terminated strings, otherwise this will read beyond |
81aecbb6bbb2
Add warnings to av_strlcat and av_strlcpy doxygen that the input strings
reimar
parents:
637
diff
changeset
|
93 * the end of the buffer and possibly crash. |
347 | 94 */ |
95 size_t av_strlcat(char *dst, const char *src, size_t size); | |
96 | |
369
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
97 /** |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
98 * Append output to a string, according to a format. Never write out of |
828 | 99 * the destination buffer, and always put a terminating 0 within |
369
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
100 * the buffer. |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
101 * @param dst destination buffer (string to which the output is |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
102 * appended) |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
103 * @param size total size of the destination buffer |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
104 * @param fmt printf-compatible format string, specifying how the |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
105 * following parameters are used |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
106 * @return the length of the string that would have been generated |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
107 * if enough space had been available |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
108 */ |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
109 size_t av_strlcatf(char *dst, size_t size, const char *fmt, ...); |
2cd0add8ac0c
Implement av_strlcatf(): a strlcat which adds a printf style formatted string
lucabe
parents:
347
diff
changeset
|
110 |
799
cb32a271f4cd
Add a function to convert a number to a av_malloced string.
michael
parents:
778
diff
changeset
|
111 /** |
cb32a271f4cd
Add a function to convert a number to a av_malloced string.
michael
parents:
778
diff
changeset
|
112 * Convert a number to a av_malloced string. |
cb32a271f4cd
Add a function to convert a number to a av_malloced string.
michael
parents:
778
diff
changeset
|
113 */ |
cb32a271f4cd
Add a function to convert a number to a av_malloced string.
michael
parents:
778
diff
changeset
|
114 char *av_d2str(double d); |
cb32a271f4cd
Add a function to convert a number to a av_malloced string.
michael
parents:
778
diff
changeset
|
115 |
567 | 116 #endif /* AVUTIL_AVSTRING_H */ |