muParser API -
1.35
|
Mathematical expressions parser. More...
#include <muParser.h>
Public Member Functions | |
Parser () | |
Constructor. More... | |
void | InitCharSets () override |
Define the character sets. More... | |
void | InitFun () override |
Initialize the default functions. | |
void | InitConst () override |
Initialize constants. More... | |
void | InitOprt () override |
Initialize operators. More... | |
void | OnDetectVar (string_type *pExpr, int &nStart, int &nEnd) override |
value_type | Diff (value_type *a_Var, value_type a_fPos, value_type a_fEpsilon=0) const |
Numerically differentiate with regard to a variable. More... | |
![]() | |
ParserBase () | |
Constructor. More... | |
ParserBase (const ParserBase &a_Parser) | |
Copy constructor. More... | |
ParserBase & | operator= (const ParserBase &a_Parser) |
Assignment operator. More... | |
value_type | Eval () const |
Calculate the result. More... | |
value_type * | Eval (int &nStackSize) const |
Evaluate an expression containing comma separated subexpressions. More... | |
void | Eval (value_type *results, int nBulkSize) |
int | GetNumResults () const |
Return the number of results on the calculation stack. More... | |
void | SetExpr (const string_type &a_sExpr) |
Set the formula. More... | |
void | SetVarFactory (facfun_type a_pFactory, void *pUserData=nullptr) |
Set a function that can create variable pointer for unknown expression variables. More... | |
void | SetDecSep (char_type cDecSep) |
Set the decimal separator. More... | |
void | SetThousandsSep (char_type cThousandsSep=0) |
Sets the thousands operator. More... | |
void | ResetLocale () |
Resets the locale. More... | |
void | EnableOptimizer (bool a_bIsOn=true) |
Enable or disable the formula optimization feature. More... | |
void | EnableBuiltInOprt (bool a_bIsOn=true) |
Enable or disable the built in binary operators. More... | |
bool | HasBuiltInOprt () const |
Query status of built in variables. More... | |
void | AddValIdent (identfun_type a_pCallback) |
Add a value parsing function. More... | |
template<typename T > | |
void | DefineFun (const string_type &a_strName, T a_pFun, bool a_bAllowOpt=true) |
Define a parser function without arguments. More... | |
template<typename T > | |
void | DefineFunUserData (const string_type &a_strName, T a_pFun, void *a_pUserData, bool a_bAllowOpt=true) |
Define a parser function with user data (not null). More... | |
void | DefineOprt (const string_type &a_strName, fun_type2 a_pFun, unsigned a_iPri=0, EOprtAssociativity a_eAssociativity=oaLEFT, bool a_bAllowOpt=false) |
Define a binary operator. More... | |
void | DefineConst (const string_type &a_sName, value_type a_fVal) |
Add a user defined constant. More... | |
void | DefineStrConst (const string_type &a_sName, const string_type &a_strVal) |
Define a new string constant. More... | |
void | DefineVar (const string_type &a_sName, value_type *a_fVar) |
Add a user defined variable. More... | |
void | DefinePostfixOprt (const string_type &a_strFun, fun_type1 a_pOprt, bool a_bAllowOpt=true) |
Add a user defined operator. More... | |
void | DefineInfixOprt (const string_type &a_strName, fun_type1 a_pOprt, int a_iPrec=prINFIX, bool a_bAllowOpt=true) |
Add a user defined operator. More... | |
void | ClearVar () |
Clear all user defined variables. More... | |
void | ClearFun () |
Clear all functions. More... | |
void | ClearConst () |
Clear all user defined constants. More... | |
void | ClearInfixOprt () |
Clear the user defined Prefix operators. More... | |
void | ClearPostfixOprt () |
Clear all user defined postfix operators. More... | |
void | ClearOprt () |
Clear all user defined binary operators. More... | |
void | RemoveVar (const string_type &a_strVarName) |
Remove a variable from internal storage. More... | |
const varmap_type & | GetUsedVar () const |
Return a map containing the used variables only. | |
const varmap_type & | GetVar () const |
Return a map containing the used variables only. | |
const valmap_type & | GetConst () const |
Return a map containing all parser constants. | |
const string_type & | GetExpr () const |
Retrieve the formula. | |
const funmap_type & | GetFunDef () const |
Return prototypes of all parser functions. More... | |
string_type | GetVersion (EParserVersionInfo eInfo=pviFULL) const |
Returns the version of muparser. More... | |
const ParserByteCode & | GetByteCode () const |
Returns the bytecode of the current expression. | |
const char_type ** | GetOprtDef () const |
Get the default symbols used for the built in operators. More... | |
void | DefineNameChars (const char_type *a_szCharset) |
Define the set of valid characters to be used in names of functions, variables, constants. | |
void | DefineOprtChars (const char_type *a_szCharset) |
Define the set of valid characters to be used in names of binary operators and postfix operators. | |
void | DefineInfixOprtChars (const char_type *a_szCharset) |
Define the set of valid characters to be used in names of infix operators. | |
const char_type * | ValidNameChars () const |
Virtual function that defines the characters allowed in name identifiers. More... | |
const char_type * | ValidOprtChars () const |
Virtual function that defines the characters allowed in operator definitions. More... | |
const char_type * | ValidInfixOprtChars () const |
Virtual function that defines the characters allowed in infix operator definitions. More... | |
void | SetArgSep (char_type cArgSep) |
Set argument separator. More... | |
char_type | GetArgSep () const |
Get the argument separator character. | |
Static Protected Member Functions | |
static int | IsVal (const char_type *a_szExpr, int *a_iPos, value_type *a_fVal) |
Default value recognition callback. More... | |
Additional Inherited Members | |
![]() | |
typedef ParserError | exception_type |
Type of the error class. More... | |
![]() | |
static void | EnableDebugDump (bool bDumpCmd, bool bDumpStack) |
Enable the dumping of bytecode and stack content on the console. More... | |
![]() | |
void | Init () |
Initialize user defined functions. More... | |
void | Error (EErrorCodes a_iErrc, int a_iPos=static_cast< int >(mu::string_type::npos), const string_type &a_strTok=string_type()) const |
Create an error containing the parse error position. More... | |
![]() | |
static const char_type * | c_DefaultOprt [] |
Identifiers for built in binary operators. More... | |
static std::locale | s_locale = std::locale(std::locale::classic(), new change_dec_sep<char_type>('.')) |
The locale used by the parser. | |
static bool | g_DbgDumpCmdCode = false |
static bool | g_DbgDumpStack = false |
Mathematical expressions parser.
Standard implementation of the mathematical expressions parser. Can be used as a reference implementation for subclassing the parser.
Definition at line 50 of file muParser.h.
mu::Parser::Parser | ( | ) |
Constructor.
Call ParserBase class constructor and trigger Function, Operator and Constant initialization.
Definition at line 79 of file muParser.cpp.
value_type mu::Parser::Diff | ( | value_type * | a_Var, |
value_type | a_fPos, | ||
value_type | a_fEpsilon = 0 |
||
) | const |
Numerically differentiate with regard to a variable.
[in] | a_Var | Pointer to the differentiation variable. |
[in] | a_fPos | Position at which the differentiation should take place. |
[in] | a_fEpsilon | Epsilon used for the numerical differentiation. |
Numerical differentiation uses a 5 point operator yielding a 4th order formula. The default value for epsilon is 0.00074 which is numeric_limits<double>::epsilon() ^ (1/5).
Definition at line 212 of file muParser.cpp.
|
overridevirtual |
Define the character sets.
This function is used for initializing the default character sets that define the characters to be useable in function and variable names and operators.
Implements mu::ParserBase.
Definition at line 97 of file muParser.cpp.
Referenced by Parser().
|
overridevirtual |
Initialize constants.
By default the parser recognizes two constants. Pi ("pi") and the Eulerian number ("_e").
Implements mu::ParserBase.
Definition at line 160 of file muParser.cpp.
Referenced by Parser().
|
overridevirtual |
Initialize operators.
By default only the unary minus operator is added.
Implements mu::ParserBase.
Definition at line 171 of file muParser.cpp.
Referenced by Parser().
|
staticprotected |
Default value recognition callback.
[in] | a_szExpr | Pointer to the expression |
[in,out] | a_iPos | Pointer to an index storing the current position within the expression |
[out] | a_fVal | Pointer where the value should be stored in case one is found. |
Definition at line 55 of file muParser.cpp.
Referenced by Parser().