PipeWire 1.2.7
|
Typedefs | |
typedef void(* | pw_destroy_t) (void *object) |
a function to destroy an item | |
Macros | |
#define | strndupa(s, n) |
#define | strdupa(s) |
#define | pw_rand32() ({ uint32_t val; pw_random(&val, sizeof(val)); val; }) |
#define | PW_DEPRECATED(v) ({ __typeof__(v) _v SPA_DEPRECATED = (v); (void)_v; (v); }) |
Functions | |
const char * | pw_split_walk (const char *str, const char *delimiter, size_t *len, const char **state) |
Split a string based on delimiters. | |
char ** | pw_split_strv (const char *str, const char *delimiter, int max_tokens, int *n_tokens) |
Split a string based on delimiters. | |
int | pw_split_ip (char *str, const char *delimiter, int max_tokens, char *tokens[]) |
Split a string in-place based on delimiters. | |
char ** | pw_strv_parse (const char *val, size_t len, int max_tokens, int *n_tokens) |
Parse an array of strings. | |
int | pw_strv_find (char **a, const char *b) |
Find a string in a NULL terminated array of strings. | |
int | pw_strv_find_common (char **a, char **b) |
Check if two NULL terminated arrays of strings have a common string. | |
void | pw_free_strv (char **str) |
Free a NULL terminated array of strings. | |
char * | pw_strip (char *str, const char *whitespace) |
Strip all whitespace before and after a string. | |
ssize_t | pw_getrandom (void *buf, size_t buflen, unsigned int flags) |
Fill a buffer with random data. | |
void | pw_random (void *buf, size_t buflen) |
Fill a buffer with random data. | |
void * | pw_reallocarray (void *ptr, size_t nmemb, size_t size) |
Various utility functions
typedef void(* pw_destroy_t) (void *object) |
a function to destroy an item
#define strndupa | ( | s, | |
n ) |
#define strdupa | ( | s | ) |
#define pw_rand32 | ( | ) | ({ uint32_t val; pw_random(&val, sizeof(val)); val; }) |
#define PW_DEPRECATED | ( | v | ) | ({ __typeof__(v) _v SPA_DEPRECATED = (v); (void)_v; (v); }) |
const char * pw_split_walk | ( | const char * | str, |
const char * | delimiter, | ||
size_t * | len, | ||
const char ** | state ) |
Split a string based on delimiters.
str | a string to split | |
delimiter | delimiter characters to split on | |
[out] | len | the length of the current string |
[in,out] | state | a state variable |
Repeatedly call this function to split str into all substrings delimited by delimiter. state should be set to NULL on the first invocation and passed to the function until NULL is returned.
char ** pw_split_strv | ( | const char * | str, |
const char * | delimiter, | ||
int | max_tokens, | ||
int * | n_tokens ) |
Split a string based on delimiters.
str | a string to split | |
delimiter | delimiter characters to split on | |
max_tokens | the max number of tokens to split | |
[out] | n_tokens | the number of tokens |
int pw_split_ip | ( | char * | str, |
const char * | delimiter, | ||
int | max_tokens, | ||
char * | tokens[] ) |
Split a string in-place based on delimiters.
str | a string to split | |
delimiter | delimiter characters to split on | |
max_tokens | the max number of tokens to split | |
[out] | tokens | an array to hold up to max_tokens of strings |
str will be modified in-place so that tokens will contain zero terminated strings split at delimiter characters.
char ** pw_strv_parse | ( | const char * | val, |
size_t | len, | ||
int | max_tokens, | ||
int * | n_tokens ) |
Parse an array of strings.
val | a string to parse | |
len | the length of val | |
max_tokens | the max number of tokens to split | |
[out] | n_tokens | the number of tokens, may be NULL |
val is parsed using relaxed json syntax.
int pw_strv_find | ( | char ** | a, |
const char * | b ) |
Find a string in a NULL terminated array of strings.
a | a strv to check |
b | the string to find |
int pw_strv_find_common | ( | char ** | a, |
char ** | b ) |
Check if two NULL terminated arrays of strings have a common string.
a | a strv to check |
b | another strv to check |
void pw_free_strv | ( | char ** | str | ) |
Free a NULL terminated array of strings.
str | a NULL terminated array of string |
Free all the strings in the array and the array
char * pw_strip | ( | char * | str, |
const char * | whitespace ) |
Strip all whitespace before and after a string.
str | a string to strip |
whitespace | characters to strip |
Strip whitespace before and after str. str will be modified.
ssize_t pw_getrandom | ( | void * | buf, |
size_t | buflen, | ||
unsigned int | flags ) |
Fill a buffer with random data.
buf | a buffer to fill |
buflen | the number of bytes to fill |
flags | optional flags |
Fill buf with buflen random bytes.
void pw_random | ( | void * | buf, |
size_t | buflen ) |
Fill a buffer with random data.
buf | a buffer to fill |
buflen | the number of bytes to fill |
Fill buf with buflen random bytes. This functions uses pw_getrandom() but falls back to a pseudo random number generator in case of failure.
void * pw_reallocarray | ( | void * | ptr, |
size_t | nmemb, | ||
size_t | size ) |