String Manipulation

Functions

int av_strstart (const char *str, const char *pfx, const char **ptr)
 Return non-zero if pfx is a prefix of str.
int av_stristart (const char *str, const char *pfx, const char **ptr)
 Return non-zero if pfx is a prefix of str independent of case.
char * av_stristr (const char *haystack, const char *needle)
 Locate the first case-independent occurrence in the string haystack of the string needle.
size_t av_strlcpy (char *dst, const char *src, size_t size)
 Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst.
size_t av_strlcat (char *dst, const char *src, size_t size)
 Append the string src to the string dst, but to a total length of no more than size - 1 bytes, and null-terminate dst.
size_t av_strlcatf (char *dst, size_t size, const char *fmt,...) av_printf_format(3
 Append output to a string, according to a format.
size_t char * av_d2str (double d)
 Convert a number to a av_malloced string.
char * av_get_token (const char **buf, const char *term)
 Unescape the given string until a non escaped terminating char, and return the token corresponding to the unescaped string.
static int av_toupper (int c)
 Locale-independent conversion of ASCII characters to uppercase.
static int av_tolower (int c)
 Locale-independent conversion of ASCII characters to lowercase.
int av_strcasecmp (const char *a, const char *b)
int av_strncasecmp (const char *a, const char *b, size_t n)
 Locale-independent case-insensitive compare.

Detailed Description

Function Documentation

size_t char* av_d2str ( double  d)

Convert a number to a av_malloced string.

Definition at line 94 of file avstring.c.

char* av_get_token ( const char **  buf,
const char *  term 
)

Unescape the given string until a non escaped terminating char, and return the token corresponding to the unescaped string.

The normal \ and ' escaping is supported. Leading and trailing whitespaces are removed, unless they are escaped with '\' or are enclosed between ''.

Parameters
bufthe buffer to parse, buf will be updated to point to the terminating char
terma 0-terminated list of terminating chars
Returns
the malloced unescaped string, which must be av_freed by the user, NULL in case of allocation failure

Definition at line 103 of file avstring.c.

Referenced by dilate_init(), init(), parse_filter(), parse_key_value_pair(), parse_link_name(), and set_params().

int av_stristart ( const char *  str,
const char *  pfx,
const char **  ptr 
)

Return non-zero if pfx is a prefix of str independent of case.

If it is, *ptr is set to the address of the first character in str after the prefix.

Parameters
strinput string
pfxprefix to test
ptrupdated if the prefix is matched inside str
Returns
non-zero if the prefix matches, zero otherwise

Definition at line 40 of file avstring.c.

Referenced by av_stristr(), ff_http_auth_handle_header(), has_header(), and rtsp_parse_range_npt().

char* av_stristr ( const char *  haystack,
const char *  needle 
)

Locate the first case-independent occurrence in the string haystack of the string needle.

A zero-length string needle is considered to match at the start of haystack.

This function is a case-insensitive version of the standard strstr().

Parameters
haystackstring to search in
needlestring to search for
Returns
pointer to the located match within haystack or a null pointer if no match

Definition at line 51 of file avstring.c.

Referenced by has_header(), and http_start_receive_data().

size_t av_strlcat ( char *  dst,
const char *  src,
size_t  size 
)

Append the string src to the string dst, but to a total length of no more than size - 1 bytes, and null-terminate dst.

This function is similar to BSD strlcat(), but differs when size <= strlen(dst).

Parameters
dstdestination buffer
srcsource string
sizesize of destination buffer
Returns
the total length of src and dst
Warning
since the return value use the length of src and dst, these absolutely must be a properly 0-terminated strings, otherwise this will read beyond the end of the buffer and possibly crash.

Definition at line 74 of file avstring.c.

Referenced by applehttp_open(), av_dict_set(), av_get_channel_layout_string(), av_printf_format(), avcodec_string(), ff_http_auth_create_response(), ff_make_absolute_url(), ff_rtsp_setup_input_streams(), ff_url_join(), matroska_convert_tag(), mmsh_open(), mov_open_dref(), query_formats(), rtp_new_connection(), rtsp_read_packet(), and show_help_options().

size_t av_strlcatf ( char *  dst,
size_t  size,
const char *  fmt,
  ... 
)

Append output to a string, according to a format.

Never write out of the destination buffer, and always put a terminating 0 within the buffer.

Parameters
dstdestination buffer (string to which the output is appended)
sizetotal size of the destination buffer
fmtprintf-compatible format string, specifying how the following parameters are used
Returns
the length of the string that would have been generated if enough space had been available
size_t av_strlcpy ( char *  dst,
const char *  src,
size_t  size 
)
int av_strncasecmp ( const char *  a,
const char *  b,
size_t  n 
)

Locale-independent case-insensitive compare.

Note
This means only ASCII-range characters are case-insensitive

Definition at line 147 of file avstring.c.

Referenced by av_parse_time(), extract_rates(), http_parse_request(), match_format(), and process_line().

int av_strstart ( const char *  str,
const char *  pfx,
const char **  ptr 
)

Return non-zero if pfx is a prefix of str.

If it is, *ptr is set to the address of the first character in str after the prefix.

Parameters
strinput string
pfxprefix to test
ptrupdated if the prefix is matched inside str
Returns
non-zero if the prefix matches, zero otherwise

Definition at line 29 of file avstring.c.

Referenced by amr_parse_sdp_line(), applehttp_open(), asfrtp_parse_sdp_line(), assert_file_overwrite(), concat_open(), crypto_open(), ff_make_absolute_url(), ff_real_parse_sdp_a_line(), ff_wms_parse_sdp_a_line(), http_open_cnx(), latm_parse_sdp_line(), md5_close(), opt_output_file(), parse_h264_sdp_line(), parse_playlist(), parse_sdp_line(), rdt_parse_sdp_line(), rtsp_probe(), sap_probe(), tls_open(), and xiph_parse_sdp_line().

static int av_tolower ( int  c)
inlinestatic

Locale-independent conversion of ASCII characters to lowercase.

Definition at line 152 of file avstring.h.

Referenced by av_strcasecmp(), and av_strncasecmp().

static int av_toupper ( int  c)
inlinestatic

Locale-independent conversion of ASCII characters to uppercase.

Definition at line 142 of file avstring.h.