libavfilter/parseutils.h File Reference

parsing utils More...

#include "libavcodec/opt.h"

Go to the source code of this file.

Functions
char *	av_get_token (const char **buf, const char *term)
	Unescapes the given string until a non escaped terminating char, and returns the token corresponding to the unescaped string.
int	av_parse_color (uint8_t *rgba_color, const char *color_string, void *log_ctx)
	Puts the RGBA values that correspond to color_string in rgba_color.
int	av_set_options_string (void *ctx, const char *opts, const char *key_val_sep, const char *pairs_sep)
	Parses the key/value pairs list in opts.

---

Detailed Description

parsing utils

Definition in file parseutils.h.

---

Function Documentation

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

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

The normal \ and ' escaping is supported. Leading and trailing whitespaces are removed.

Parameters:

	term	a 0-terminated list of terminating chars
	buf	the buffer to parse, buf will be updated to point to the terminating char

Returns:

the malloced unescaped string, which must be av_freed by the user

Definition at line 32 of file parseutils.c.

Referenced by parse_filter(), parse_key_value_pair(), and parse_link_name().

int av_parse_color	(	uint8_t *	rgba_color,
		const char *	color_string,
		void *	log_ctx
	)

Puts the RGBA values that correspond to color_string in rgba_color.

Parameters:

color_string

a string specifying a color. It can be the name of a color (case insensitive match) or a 0xRRGGBB[AA] sequence. The string "random" will result in a random color.

Returns:

>= 0 in case of success, a negative value in case of failure (for example if color_string cannot be parsed).

Definition at line 218 of file parseutils.c.

int av_set_options_string	(	void *	ctx,
		const char *	opts,
		const char *	key_val_sep,
		const char *	pairs_sep
	)

Parses the key/value pairs list in opts.

For each key/value pair found, stores the value in the field in ctx that is named like the key. ctx must be an AVClass context, storing is done using AVOptions.

Parameters:

	key_val_sep	a 0-terminated list of characters used to separate key from value
	pairs_sep	a 0-terminated list of characters used to separate two pairs from each other

Returns:

the number of successfully set key/value pairs, or a negative value corresponding to an AVERROR code in case of error: AVERROR(EINVAL) if opts cannot be parsed, the error code issued by av_set_string3() if a key/value pair cannot be set

Definition at line 303 of file parseutils.c.