ffmpeg / libavutil / avstring.h @ 4b2be143
History | View | Annotate | Download (2.98 KB)
| 1 | fc78ce80 | Måns Rullgård | /*
|
|---|---|---|---|
| 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 | |||
| 21 | 98790382 | Stefano Sabatini | #ifndef AVUTIL_AVSTRING_H
|
| 22 | #define AVUTIL_AVSTRING_H
|
||
| 23 | fc78ce80 | Måns Rullgård | |
| 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
|
||
| 32 | 7d685b48 | Diego Biurrun | * @param ptr updated if the prefix is matched inside str
|
| 33 | fc78ce80 | Måns Rullgård | * @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
|
||
| 44 | 7d685b48 | Diego Biurrun | * @param ptr updated if the prefix is matched inside str
|
| 45 | fc78ce80 | Måns Rullgård | * @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 | /**
|
||
| 50 | * Copy the string src to dst, but no more than size - 1 bytes, and
|
||
| 51 | 89c9ff50 | Diego Biurrun | * null-terminate dst.
|
| 52 | fc78ce80 | Måns Rullgård | *
|
| 53 | * This function is the same as BSD strlcpy().
|
||
| 54 | *
|
||
| 55 | * @param dst destination buffer
|
||
| 56 | * @param src source string
|
||
| 57 | * @param size size of destination buffer
|
||
| 58 | * @return the length of src
|
||
| 59 | */
|
||
| 60 | size_t av_strlcpy(char *dst, const char *src, size_t size); |
||
| 61 | |||
| 62 | /**
|
||
| 63 | * Append the string src to the string dst, but to a total length of
|
||
| 64 | 89c9ff50 | Diego Biurrun | * no more than size - 1 bytes, and null-terminate dst.
|
| 65 | fc78ce80 | Måns Rullgård | *
|
| 66 | * This function is similar to BSD strlcat(), but differs when
|
||
| 67 | * size <= strlen(dst).
|
||
| 68 | *
|
||
| 69 | * @param dst destination buffer
|
||
| 70 | * @param src source string
|
||
| 71 | * @param size size of destination buffer
|
||
| 72 | * @return the total length of src and dst
|
||
| 73 | */
|
||
| 74 | size_t av_strlcat(char *dst, const char *src, size_t size); |
||
| 75 | |||
| 76 | 1e7f3638 | Luca Abeni | /**
|
| 77 | * Append output to a string, according to a format. Never write out of
|
||
| 78 | * the destination buffer, and and always put a terminating 0 within
|
||
| 79 | * the buffer.
|
||
| 80 | * @param dst destination buffer (string to which the output is
|
||
| 81 | * appended)
|
||
| 82 | * @param size total size of the destination buffer
|
||
| 83 | * @param fmt printf-compatible format string, specifying how the
|
||
| 84 | * following parameters are used
|
||
| 85 | * @return the length of the string that would have been generated
|
||
| 86 | * if enough space had been available
|
||
| 87 | */
|
||
| 88 | size_t av_strlcatf(char *dst, size_t size, const char *fmt, ...); |
||
| 89 | |||
| 90 | 98790382 | Stefano Sabatini | #endif /* AVUTIL_AVSTRING_H */ |