OpenShot Library | OpenShotAudio  0.2.2
juce::Expression Class Reference

A class for dynamically evaluating simple numeric expressions. More...

#include <juce_Expression.h>

Classes

struct  Helpers
 
class  Scope
 When evaluating an Expression object, this class is used to resolve symbols and perform functions that the expression uses. More...
 
struct  Symbol
 Represents a symbol that is used in an Expression. More...
 
class  Term
 

Public Types

enum  Type { constantType , functionType , operatorType , symbolType }
 Expression type. More...
 

Public Member Functions

 Expression ()
 Creates a simple expression with a value of 0.
 
 ~Expression ()
 Destructor.
 
 Expression (const Expression &)
 Creates a copy of an expression.
 
Expressionoperator= (const Expression &)
 Copies another expression.
 
 Expression (Expression &&) noexcept
 Move constructor.
 
Expressionoperator= (Expression &&) noexcept
 Move assignment operator.
 
 Expression (double constant)
 Creates a simple expression with a specified constant value.
 
 Expression (const String &stringToParse, String &parseError)
 Attempts to create an expression by parsing a string. More...
 
String toString () const
 Returns a string version of the expression.
 
Expression operator+ (const Expression &) const
 Returns an expression which is an addition operation of two existing expressions.
 
Expression operator- (const Expression &) const
 Returns an expression which is a subtraction operation of two existing expressions.
 
Expression operator* (const Expression &) const
 Returns an expression which is a multiplication operation of two existing expressions.
 
Expression operator/ (const Expression &) const
 Returns an expression which is a division operation of two existing expressions.
 
Expression operator- () const
 Returns an expression which performs a negation operation on an existing expression.
 
double evaluate () const
 Evaluates this expression, without using a Scope. More...
 
double evaluate (const Scope &scope) const
 Evaluates this expression, providing a scope that should be able to evaluate any symbols or functions that it uses. More...
 
double evaluate (const Scope &scope, String &evaluationError) const
 Evaluates this expression, providing a scope that should be able to evaluate any symbols or functions that it uses.
 
Expression adjustedToGiveNewResult (double targetValue, const Scope &scope) const
 Attempts to return an expression which is a copy of this one, but with a constant adjusted to make the expression resolve to a target value. More...
 
Expression withRenamedSymbol (const Symbol &oldSymbol, const String &newName, const Scope &scope) const
 Returns a copy of this expression in which all instances of a given symbol have been renamed.
 
bool referencesSymbol (const Symbol &symbol, const Scope &scope) const
 Returns true if this expression makes use of the specified symbol. More...
 
bool usesAnySymbols () const
 Returns true if this expression contains any symbols.
 
void findReferencedSymbols (Array< Symbol > &results, const Scope &scope) const
 Returns a list of all symbols that may be needed to resolve this expression in the given scope.
 
Type getType () const noexcept
 Returns the type of this expression.
 
String getSymbolOrFunction () const
 If this expression is a symbol, function or operator, this returns its identifier.
 
int getNumInputs () const
 Returns the number of inputs to this expression. More...
 
Expression getInput (int index) const
 Retrieves one of the inputs to this expression. More...
 

Static Public Member Functions

static Expression symbol (const String &symbol)
 Returns an Expression which is an identifier reference.
 
static Expression function (const String &functionName, const Array< Expression > &parameters)
 Returns an Expression which is a function call.
 
static Expression parse (String::CharPointerType &stringToParse, String &parseError)
 Returns an Expression which parses a string from a character pointer, and updates the pointer to indicate where it finished. More...
 

Detailed Description

A class for dynamically evaluating simple numeric expressions.

This class can parse a simple C-style string expression involving floating point numbers, named symbols and functions. The basic arithmetic operations of +, -, *, / are supported, as well as parentheses, and any alphanumeric identifiers are assumed to be named symbols which will be resolved when the expression is evaluated.

Expressions which use identifiers and functions require a subclass of Expression::Scope to be supplied when evaluating them, and this object is expected to be able to resolve the symbol names and perform the functions that are used.

Definition at line 47 of file juce_Expression.h.

Member Enumeration Documentation

◆ Type

Expression type.

See also
Expression::getType()

Definition at line 222 of file juce_Expression.h.

Constructor & Destructor Documentation

◆ Expression()

juce::Expression::Expression ( const String stringToParse,
String parseError 
)

Attempts to create an expression by parsing a string.

Any errors are returned in the parseError argument provided.

Definition at line 964 of file juce_Expression.cpp.

References juce::String::getCharPointer().

Member Function Documentation

◆ parse()

Expression juce::Expression::parse ( String::CharPointerType stringToParse,
String parseError 
)
static

Returns an Expression which parses a string from a character pointer, and updates the pointer to indicate where it finished.

The pointer is incremented so that on return, it indicates the character that follows the end of the expression that was parsed.

If there's a syntax error in parsing, the parseError argument will be set to a description of the problem.

Definition at line 972 of file juce_Expression.cpp.

References juce::ReferenceCountedObjectPtr< ObjectType >::get().

◆ evaluate() [1/2]

double juce::Expression::evaluate ( ) const

Evaluates this expression, without using a Scope.

Without a Scope, no symbols can be used, and only basic functions such as sin, cos, tan, min, max are available. To find out about any errors during evaluation, use the other version of this method which takes a String parameter.

Definition at line 980 of file juce_Expression.cpp.

Referenced by evaluate().

◆ evaluate() [2/2]

double juce::Expression::evaluate ( const Scope scope) const

Evaluates this expression, providing a scope that should be able to evaluate any symbols or functions that it uses.

To find out about any errors during evaluation, use the other version of this method which takes a String parameter.

Definition at line 985 of file juce_Expression.cpp.

References evaluate().

◆ adjustedToGiveNewResult()

Expression juce::Expression::adjustedToGiveNewResult ( double  targetValue,
const Scope scope 
) const

Attempts to return an expression which is a copy of this one, but with a constant adjusted to make the expression resolve to a target value.

E.g. if the expression is "x + 10" and x is 5, then asking for a target value of 8 will return the expression "x + 3". Obviously some expressions can't be reversed in this way, in which case they might just be adjusted by adding a constant to the original expression.

Exceptions
Expression::EvaluationError

Definition at line 1017 of file juce_Expression.cpp.

References Expression().

◆ referencesSymbol()

bool juce::Expression::referencesSymbol ( const Symbol symbol,
const Scope scope 
) const

Returns true if this expression makes use of the specified symbol.

If a suitable scope is supplied, the search will dereference and recursively check all symbols, so that it can be determined whether this expression relies on the given symbol at any level in its evaluation. If the scope parameter is null, this just checks whether the expression contains any direct references to the symbol.

Exceptions
Expression::EvaluationError

Definition at line 1061 of file juce_Expression.cpp.

◆ getNumInputs()

int juce::Expression::getNumInputs ( ) const

Returns the number of inputs to this expression.

See also
getInput

Definition at line 1090 of file juce_Expression.cpp.

◆ getInput()

Expression juce::Expression::getInput ( int  index) const

Retrieves one of the inputs to this expression.

See also
getNumInputs

Definition at line 1091 of file juce_Expression.cpp.

References Expression().


The documentation for this class was generated from the following files: