simple arithmetic expression evaluator. More...

#include <float.h>
#include "attributes.h"
#include "avutil.h"
#include "common.h"
#include "eval.h"
#include "ffmath.h"
#include "internal.h"
#include "log.h"
#include "mathematics.h"
#include "time.h"
#include "avstring.h"
#include "timer.h"
#include "reverse.h"

Data Structures
struct	Parser

struct	AVExpr

Macros
#define	VARS 10

#define	IS_IDENTIFIER_CHAR(c) ((c) - '0' <= 9U \|\| (c) - 'a' <= 25U \|\| (c) - 'A' <= 25U \|\| (c) == '_')

Functions
double	av_strtod (const char numstr, char *tail)
	Parse the string in numstr and return its value as a double. More...

static int	strmatch (const char s, const char prefix)

static double	etime (double v)

static double	eval_expr (Parser p, AVExpr e)

static int	parse_expr (AVExpr *e, Parser p)

void	av_expr_free (AVExpr *e)
	Free a parsed expression previously created with av_expr_parse(). More...

static int	parse_primary (AVExpr *e, Parser p)

static AVExpr *	make_eval_expr (int type, int value, AVExpr p0, AVExpr p1)

static int	parse_pow (AVExpr *e, Parser p, int *sign)

static int	parse_dB (AVExpr *e, Parser p, int *sign)

static int	parse_factor (AVExpr *e, Parser p)

static int	parse_term (AVExpr *e, Parser p)

static int	parse_subexpr (AVExpr *e, Parser p)

static int	verify_expr (AVExpr *e)

int	av_expr_parse (AVExpr *expr, const char s, const char const const_names, const char const func1_names, double(const funcs1)(void , double), const char const func2_names, double(const funcs2)(void , double, double), int log_offset, void *log_ctx)
	Parse an expression. More...

double	av_expr_eval (AVExpr e, const double const_values, void *opaque)
	Evaluate a previously parsed expression. More...

int	av_expr_parse_and_eval (double d, const char s, const char const const_names, const double const_values, const char const func1_names, double(const funcs1)(void , double), const char const func2_names, double(const funcs2)(void , double, double), void opaque, int log_offset, void *log_ctx)
	Parse and evaluate an expression. More...

Variables
static const AVClass	eval_class = { "Eval", av_default_item_name, NULL, LIBAVUTIL_VERSION_INT, 0x42, 0x42 }

struct {
double bin_val

double dec_val

int8_t exp

}	si_prefixes ['z'- 'E'+1]

struct {
const char * name

double value

}	constants []

Detailed Description

simple arithmetic expression evaluator.

see http://joe.hotchkiss.com/programming/eval/eval.html

Definition in file eval.c.

Macro Definition Documentation

#define VARS 10

Definition at line 56 of file eval.c.

Referenced by av_expr_parse(), and eval_expr().

#define IS_IDENTIFIER_CHAR ( c ) ((c) - '0' <= 9U || (c) - 'a' <= 25U || (c) - 'A' <= 25U || (c) == '_')

Definition at line 138 of file eval.c.

Referenced by strmatch().

Function Documentation

double av_strtod	(	const char *	numstr,
		char **	tail
	)

Parse the string in numstr and return its value as a double.

If the string is empty, contains only whitespaces, or does not contain an initial substring that has the expected syntax for a floating-point number, no conversion is performed. In this case, returns a value of zero and the value returned in tail is the value of numstr.

Parameters

numstr	a string representing a number, may contain one of the International System number postfixes, for example 'K', 'M', 'G'. If 'i' is appended after the postfix, powers of 2 are used instead of powers of 10. The 'B' postfix multiplies the value by 8, and can be appended after another postfix or used alone. This allows using for example 'KB', 'MiB', 'G' and 'B' as postfix.
tail	if non-NULL puts here the pointer to the char next after the last parsed character

Definition at line 99 of file eval.c.

Referenced by ff_parse_sample_rate(), open_output_file(), parse_number_or_die(), parse_points_str(), parse_primary(), set_param(), var_read_float(), X264_init(), and yae_set_tempo().

static int strmatch	(	const char *	s,
		const char *	prefix
	)

static

Definition at line 140 of file eval.c.

Referenced by parse_primary().

static double etime ( double v )

static

Definition at line 171 of file eval.c.

Referenced by parse_primary().

static double eval_expr	(	Parser *	p,
		AVExpr *	e
	)

static

Definition at line 176 of file eval.c.

Referenced by av_expr_eval().

static int parse_expr	(	AVExpr **	e,
		Parser *	p
	)

static

Definition at line 603 of file eval.c.

Referenced by av_expr_parse(), and parse_primary().

void av_expr_free ( AVExpr * e )

Free a parsed expression previously created with av_expr_parse().

Definition at line 327 of file eval.c.

Referenced by av_expr_free(), av_expr_parse(), av_expr_parse_and_eval(), avfilter_free(), config_input(), config_output(), config_props(), ff_rate_control_uninit(), ffmpeg_cleanup(), generate_kernel(), geq_uninit(), init(), init_axis_color(), init_cqt(), init_volume(), parse_channel_expressions(), parse_expr(), parse_factor(), parse_primary(), parse_subexpr(), parse_term(), process_command(), set_enable_expr(), set_expr(), and uninit().

static int parse_primary	(	AVExpr **	e,
		Parser *	p
	)

static

Definition at line 337 of file eval.c.

Referenced by parse_dB(), and parse_pow().

static AVExpr* make_eval_expr	(	int	type,
		int	value,
		AVExpr *	p0,
		AVExpr *	p1
	)

static

Definition at line 494 of file eval.c.

Referenced by parse_expr(), parse_factor(), parse_subexpr(), and parse_term().

static int parse_pow	(	AVExpr **	e,
		Parser *	p,
		int *	sign
	)

static

Definition at line 506 of file eval.c.

Referenced by parse_dB().

static int parse_dB	(	AVExpr **	e,
		Parser *	p,
		int *	sign
	)

static

Definition at line 513 of file eval.c.

Referenced by parse_factor().

static int parse_factor	(	AVExpr **	e,
		Parser *	p
	)

static

Definition at line 528 of file eval.c.

Referenced by parse_term().

static int parse_term	(	AVExpr **	e,
		Parser *	p
	)

static

Definition at line 555 of file eval.c.

Referenced by parse_subexpr().

static int parse_subexpr	(	AVExpr **	e,
		Parser *	p
	)

static

Definition at line 579 of file eval.c.

Referenced by parse_expr().

static int verify_expr ( AVExpr * e )

static

Definition at line 633 of file eval.c.

Referenced by av_expr_parse().

int av_expr_parse	(	AVExpr **	expr,
		const char *	s,
		const char const	const_names,
		const char const	func1_names,
		double(*)(void , double)	funcs1,
		const char const	func2_names,
		double(*)(void , double, double)	funcs2,
		int	log_offset,
		void *	log_ctx
	)

Parse an expression.

Parameters

expr	a pointer where is put an AVExpr containing the parsed value in case of successful parsing, or NULL otherwise. The pointed to AVExpr must be freed with av_expr_free() by the user when it is not needed anymore.
s	expression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
const_names	NULL terminated array of zero terminated strings of constant identifiers, for example {"PI", "E", 0}
func1_names	NULL terminated array of zero terminated strings of funcs1 identifiers
funcs1	NULL terminated array of function pointers for functions which take 1 argument
func2_names	NULL terminated array of zero terminated strings of funcs2 identifiers
funcs2	NULL terminated array of function pointers for functions which take 2 arguments
log_ctx	parent logging context

Returns: >= 0 in case of success, a negative value corresponding to an AVERROR code otherwise

Definition at line 672 of file eval.c.

Referenced by av_expr_parse_and_eval(), config_input(), config_output(), config_props(), ff_rate_control_init(), generate_kernel(), geq_init(), init(), init_axis_color(), init_cqt(), init_output_stream_encode(), init_volume(), initialize(), modplug_read_header(), parse_fontsize(), process_command(), set_enable_expr(), and set_expr().

double av_expr_eval	(	AVExpr *	e,
		const double *	const_values,
		void *	opaque
	)

Evaluate a previously parsed expression.

Parameters

const_values	a zero terminated array of values for the identifiers from av_expr_parse() const_names
opaque	a pointer which will be passed to all functions from funcs1 and funcs2

Returns: the value of the expression

Definition at line 727 of file eval.c.

Referenced by av_expr_parse_and_eval(), config_input(), config_output(), config_props(), do_eval(), do_video_out(), draw_text(), eval_expr(), ff_inlink_evaluate_timeline_at_frame(), filter_frame(), generate_kernel(), geq_filter_frame(), get_qscale(), init_axis_color(), init_cqt(), init_volume(), modplug_read_packet(), output_single_frame(), parse_expr(), request_frame(), select_frame(), set_brightness(), set_contrast(), set_gamma(), set_saturation(), set_volume(), update_alpha(), update_context(), and update_fontsize().

int av_expr_parse_and_eval	(	double *	res,
		const char *	s,
		const char const	const_names,
		const double *	const_values,
		const char const	func1_names,
		double(*)(void , double)	funcs1,
		const char const	func2_names,
		double(*)(void , double, double)	funcs2,
		void *	opaque,
		int	log_offset,
		void *	log_ctx
	)

Parse and evaluate an expression.

Note, this is significantly slower than av_expr_eval().

Parameters

res	a pointer to a double where is put the result value of the expression, or NAN in case of error
s	expression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
const_names	NULL terminated array of zero terminated strings of constant identifiers, for example {"PI", "E", 0}
const_values	a zero terminated array of values for the identifiers from const_names
func1_names	NULL terminated array of zero terminated strings of funcs1 identifiers
funcs1	NULL terminated array of function pointers for functions which take 1 argument
func2_names	NULL terminated array of zero terminated strings of funcs2 identifiers
funcs2	NULL terminated array of function pointers for functions which take 2 arguments
opaque	a pointer which will be passed to all functions from funcs1 and funcs2
log_ctx	parent logging context

Returns: >= 0 in case of success, a negative value corresponding to an AVERROR code otherwise

Definition at line 737 of file eval.c.

Referenced by activate(), av_parse_ratio(), calc_persp_luts(), config_input(), config_output_props(), config_props(), ff_scale_eval_dimensions(), filter_frame(), func_eval_expr(), func_eval_expr_int_format(), generate_kernel(), get_aspect_ratio(), init(), main(), qsvscale_config_props(), and set_string_number().

Variable Documentation

const AVClass eval_class = { "Eval", av_default_item_name, NULL, LIBAVUTIL_VERSION_INT, 0x42, 0x42 }

static

Definition at line 60 of file eval.c.

Referenced by av_expr_parse().

double bin_val

Definition at line 63 of file eval.c.

double dec_val

Definition at line 64 of file eval.c.

int8_t exp

Definition at line 65 of file eval.c.

Referenced by ac3_exponent_min_c(), acelp_decode_gain_codef(), adpcm_decode_frame(), apply_channel_coupling(), ath(), av_div_sf_ieee754(), av_mul_sf_ieee754(), bessel(), bitreduction(), comp_harmonic_coeff(), compute_exp_strategy(), config_input(), config_output(), create_freq_table(), decode(), decode_aiff_header(), decode_subframe(), e2_m16(), encode_codeword(), encode_exp_vlc(), encode_exponents(), erf(), estimate_pitch(), eval_expr(), evrc_decode_frame(), exr_flt2uint(), exr_half2float(), exr_halflt2uint(), fade_gain(), ff_acelp_decode_gain_code(), generate_min_phase_kernel(), generate_window_func(), get_aiff_header(), get_volume(), hom(), init(), init_gaussian_filter(), init_pass2(), mdct15(), modify_qscale(), mult(), output_gain(), parse_mantissas(), parse_primary(), put_float(), qdm2_fft_decode_tones(), qdm2_fft_init_coefficient(), quant(), sbr_hf_g_filt_c(), set_default_ctl_value(), stream_component_open(), swri_dither_init(), sws_getGaussianVec(), twinvq_mulawinv(), vorbis_floor0_decode(), vorbisfloat2float(), and wv_get_value_float().

const { ... } si_prefixes['z' - 'E' + 1]

Initial value:

= {
    ['y'-'E']= { 8.271806125530276749e-25, 1e-24, -24 },
    ['z'-'E']= { 8.4703294725430034e-22, 1e-21, -21 },
    ['a'-'E']= { 8.6736173798840355e-19, 1e-18, -18 },
    ['f'-'E']= { 8.8817841970012523e-16, 1e-15, -15 },
    ['p'-'E']= { 9.0949470177292824e-13, 1e-12, -12 },
    ['n'-'E']= { 9.3132257461547852e-10, 1e-9,  -9 },
    ['u'-'E']= { 9.5367431640625e-7, 1e-6, -6 },
    ['m'-'E']= { 9.765625e-4, 1e-3, -3 },
    ['c'-'E']= { 9.8431332023036951e-3, 1e-2, -2 },
    ['d'-'E']= { 9.921256574801246e-2, 1e-1, -1 },
    ['h'-'E']= { 1.0159366732596479e2, 1e2, 2 },
    ['k'-'E']= { 1.024e3, 1e3, 3 },
    ['K'-'E']= { 1.024e3, 1e3, 3 },
    ['M'-'E']= { 1.048576e6, 1e6, 6 },
    ['G'-'E']= { 1.073741824e9, 1e9, 9 },
    ['T'-'E']= { 1.099511627776e12, 1e12, 12 },
    ['P'-'E']= { 1.125899906842624e15, 1e15, 15 },
    ['E'-'E']= { 1.152921504606847e18, 1e18, 18 },
    ['Z'-'E']= { 1.1805916207174113e21, 1e21, 21 },
    ['Y'-'E']= { 1.2089258196146292e24, 1e24, 24 },
}

Referenced by av_strtod().

const char* name

Definition at line 90 of file eval.c.

double value

Definition at line 91 of file eval.c.

Referenced by make_eval_expr().

const { ... } constants[]

Initial value:

= {
    { "E",   M_E   },
    { "PI",  M_PI  },
    { "PHI", M_PHI },
    { "QP2LAMBDA", FF_QP2LAMBDA },
}

Referenced by parse_primary().

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

Function Documentation

Variable Documentation