Libav
Functions

String Manipulation
[Common utility functions]

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.
char * av_strnstr (const char *haystack, const char *needle, size_t hay_length)
 Locate the first occurrence of the string needle in the string haystack where not more than hay_length characters are searched.
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.
int av_isdigit (int c)
 Locale-independent conversion of ASCII isdigit.
int av_isgraph (int c)
 Locale-independent conversion of ASCII isgraph.
int av_isspace (int c)
 Locale-independent conversion of ASCII isspace.
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_isxdigit (int c)
 Locale-independent conversion of ASCII isxdigit.
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.
const char * av_basename (const char *path)
 Thread safe basename.
const char * av_dirname (char *path)
 Thread safe dirname.

Function Documentation

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:
str input string
pfx prefix to test
ptr updated if the prefix is matched inside str
Returns:
non-zero if the prefix matches, zero otherwise
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:
str input string
pfx prefix to test
ptr updated if the prefix is matched inside str
Returns:
non-zero if the prefix matches, zero otherwise
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:
haystack string to search in
needle string to search for
Returns:
pointer to the located match within haystack or a null pointer if no match
char* av_strnstr ( const char *  haystack,
const char *  needle,
size_t  hay_length 
)

Locate the first occurrence of the string needle in the string haystack where not more than hay_length characters are searched.

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

This function is a length-limited version of the standard strstr().

Parameters:
haystack string to search in
needle string to search for
hay_length length of string to search in
Returns:
pointer to the located match within haystack or a null pointer if no match
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.

This function is the same as BSD strlcpy().

Parameters:
dst destination buffer
src source string
size size of destination buffer
Returns:
the length of src
Warning:
since the return value is the length of src, src absolutely _must_ be a properly 0-terminated string, otherwise this will read beyond the end of the buffer and possibly crash.
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:
dst destination buffer
src source string
size size 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.
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:
dst destination buffer (string to which the output is appended)
size total size of the destination buffer
fmt printf-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 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.

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

Parameters:
buf the buffer to parse, buf will be updated to point to the terminating char
term a 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
int av_isdigit ( int  c  ) 

Locale-independent conversion of ASCII isdigit.

int av_isgraph ( int  c  ) 

Locale-independent conversion of ASCII isgraph.

int av_isspace ( int  c  ) 

Locale-independent conversion of ASCII isspace.

static int av_toupper ( int  c  )  [inline, static]

Locale-independent conversion of ASCII characters to uppercase.

Definition at line 172 of file avstring.h.

static int av_tolower ( int  c  )  [inline, static]

Locale-independent conversion of ASCII characters to lowercase.

Definition at line 182 of file avstring.h.

int av_isxdigit ( int  c  ) 

Locale-independent conversion of ASCII isxdigit.

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.

Note:
This means only ASCII-range characters are case-insensitive
const char* av_basename ( const char *  path  ) 

Thread safe basename.

Parameters:
path the path, on DOS both \ and / are considered separators.
Returns:
pointer to the basename substring.
const char* av_dirname ( char *  path  ) 

Thread safe dirname.

Parameters:
path the path, on DOS both \ and / are considered separators.
Returns:
the path with the separator replaced by the string terminator or ".".
Note:
the function may change the input string.