/*

   _____  __ _____________ _______  ______ ___________

  /     \|  |  \____ \__  \\_  __ \/  ___// __ \_  __ \

   |  Y Y  \  |  /  |_> > __ \|  | \/\___ \\  ___/|  | \/

   |__|_|  /____/|   __(____  /__|  /____  >\___  >__|

     \/      |__|       \/           \/     \/

   Copyright (C) 2004 - 2026 Ingo Berg

  Redistribution and use in source and binary forms, with or without modification, are permitted

  provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice, this list of

    conditions and the following disclaimer.

    * Redistributions in binary form must reproduce the above copyright notice, this list of

    conditions and the following disclaimer in the documentation and/or other materials provided

    with the distribution.

  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR

  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND

  FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR

  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER

  IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

#ifndef MU_PARSER_BASE_H

#define MU_PARSER_BASE_H

//--- Standard includes ------------------------------------------------------------------------

#include <cmath>

#include <string>

#include <iostream>

#include <map>

#include <memory>

#include <locale>

#include <limits.h>

//--- Parser includes --------------------------------------------------------------------------

#include "muParserDef.h"

#include "muParserTokenReader.h"

#include "muParserBytecode.h"

#include "muParserError.h"

#if defined(_MSC_VER)

  #pragma warning(push)

  #pragma warning(disable : 4251)  // ...needs to have dll-interface to be used by clients of class ...

#endif

namespace mu

{

  namespace Test {

    class ParserTester;

  }

  /** \file

    \brief This file contains the class definition of the muparser engine.

  */

  /** \brief Mathematical expressions parser (base parser engine).

    This is the implementation of a bytecode based mathematical expressions parser.

    The formula will be parsed from string and converted into a bytecode.

    Future calculations will be done with the bytecode instead the formula string

    resulting in a significant performance increase.

    Complementary to a set of internally implemented functions the parser is able to handle

    user defined functions and variables.

  */

  class API_EXPORT_CXX ParserBase

  {

    friend class ParserTokenReader;

    friend class mu::Test::ParserTester;

  private:

    /** \brief Typedef for the parse functions.

      The parse function do the actual work. The parser exchanges

      the function pointer to the parser function depending on

      which state it is in. (i.e. bytecode parser vs. string parser)

    */

    typedef value_type(ParserBase::* ParseFunction)() const;

    /** \brief Type used for storing an array of values. */

    typedef std::vector<value_type> valbuf_type;

    /** \brief Type for a vector of strings. */

    typedef std::vector<string_type> stringbuf_type;

    /** \brief Typedef for the token reader. */

    typedef ParserTokenReader token_reader_type;

    /** \brief Type used for parser tokens. */

    typedef ParserToken<value_type, string_type> token_type;

    /** \brief Maximum number of threads spawned by OpenMP when using the bulk mode. */

    static const int s_MaxNumOpenMPThreads;

  public:

    /** \brief Type of the error class.

      Included for backwards compatibility.

    */

    typedef ParserError exception_type;

    static void EnableDebugDump(bool bDumpCmd, bool bDumpStack);

    ParserBase();

    ParserBase(const ParserBase& a_Parser);

    ParserBase& operator=(const ParserBase& a_Parser);

    virtual ~ParserBase();

    value_type Eval() const;

    value_type* Eval(int& nStackSize) const;

    void Eval(value_type* results, int nBulkSize);

    int GetNumResults() const;

    void SetExpr(const string_type& a_sExpr);

    void SetVarFactory(facfun_type a_pFactory, void* pUserData = nullptr);

    void SetDecSep(char_type cDecSep);

    void SetThousandsSep(char_type cThousandsSep = 0);

    void ResetLocale();

    void EnableOptimizer(bool a_bIsOn = true);

    void EnableBuiltInOprt(bool a_bIsOn = true);

    bool HasBuiltInOprt() const;

    void AddValIdent(identfun_type a_pCallback);

    /** \fn void mu::ParserBase::DefineFun(const string_type &a_strName, fun_type0 a_pFun, bool a_bAllowOpt = true)

      \brief Define a parser function without arguments.

      \param a_strName Name of the function

      \param a_pFun Pointer to the callback function

      \param a_bAllowOpt A flag indicating this function may be optimized

    */

    template<typename T>

    void DefineFun(const string_type& a_strName, T a_pFun, bool a_bAllowOpt = true)

    {

      AddCallback(a_strName, ParserCallback(a_pFun, a_bAllowOpt), m_FunDef, ValidNameChars());

    }

void mu::ParserBase::DefineFun<double (*)(double)>(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&, double (*)(double), bool)

Line

Count

Source

145

88.8k

    {

146

88.8k

      AddCallback(a_strName, ParserCallback(a_pFun, a_bAllowOpt), m_FunDef, ValidNameChars());

147

88.8k

    }

void mu::ParserBase::DefineFun<double (*)(double, double)>(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&, double (*)(double, double), bool)

Line

Count

Source

145

3.86k

    {

146

3.86k

      AddCallback(a_strName, ParserCallback(a_pFun, a_bAllowOpt), m_FunDef, ValidNameChars());

147

3.86k

    }

void mu::ParserBase::DefineFun<double (*)(double const*, int)>(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&, double (*)(double const*, int), bool)

Line

Count

Source

145

15.4k

    {

146

15.4k

      AddCallback(a_strName, ParserCallback(a_pFun, a_bAllowOpt), m_FunDef, ValidNameChars());

147

15.4k

    }

void mu::ParserBase::DefineFun<double (*)()>(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&, double (*)(), bool)

Line

Count

Source

145

3.86k

    {

146

3.86k

      AddCallback(a_strName, ParserCallback(a_pFun, a_bAllowOpt), m_FunDef, ValidNameChars());

147

3.86k

    }

    /** \fn void mu::ParserBase::DefineFunUserData

      \brief Define a parser function with user data (not null).

      \param a_strName Name of the function

      \param a_pFun Pointer to the callback function

      \param a_pUserData Pointer that will be passed back to callback (shall not be nullptr)

      \param a_bAllowOpt A flag indicating this function may be optimized

    */

    template<typename T>

    void DefineFunUserData(const string_type& a_strName, T a_pFun, void* a_pUserData, bool a_bAllowOpt = true)

    {

      AddCallback(a_strName, ParserCallback(a_pFun, a_pUserData, a_bAllowOpt), m_FunDef, ValidNameChars());

    }

        /** \brief Checks the existence of a function by name.

         This method determines whether a function with the specified name

         is defined in the parser's function registry.

         \param a_strName The name of the function to check.

         \return True if the function exists, otherwise false.

         */

        bool HasFun(const string_type& a_strName) const;

    void DefineOprt(const string_type& a_strName, fun_type2 a_pFun, unsigned a_iPri = 0, EOprtAssociativity a_eAssociativity = oaLEFT, bool a_bAllowOpt = false);

    void DefineConst(const string_type& a_sName, value_type a_fVal);

    void DefineStrConst(const string_type& a_sName, const string_type& a_strVal);

    void DefineVar(const string_type& a_sName, value_type* a_fVar);

    void DefinePostfixOprt(const string_type& a_strFun, fun_type1 a_pOprt, bool a_bAllowOpt = true);

    void DefineInfixOprt(const string_type& a_strName, fun_type1 a_pOprt, int a_iPrec = prINFIX, bool a_bAllowOpt = true);

    // Clear user defined variables, constants or functions

    void ClearVar();

    void ClearFun();

    void ClearConst();

    void ClearInfixOprt();

    void ClearPostfixOprt();

    void ClearOprt();

    void RemoveVar(const string_type& a_strVarName);

    const varmap_type& GetUsedVar() const;

    const varmap_type& GetVar() const;

    const valmap_type& GetConst() const;

    const string_type& GetExpr() const;

    const funmap_type& GetFunDef() const;

    string_type GetVersion(EParserVersionInfo eInfo = pviFULL) const;

    const ParserByteCode& GetByteCode() const;

    const char_type** GetOprtDef() const;

    void DefineNameChars(const char_type* a_szCharset);

    void DefineOprtChars(const char_type* a_szCharset);

    void DefineInfixOprtChars(const char_type* a_szCharset);

    const char_type* ValidNameChars() const;

    const char_type* ValidOprtChars() const;

    const char_type* ValidInfixOprtChars() const;

    void SetArgSep(char_type cArgSep);

    void SetByteCode(const ParserByteCode& a_ByteCode);

    char_type GetArgSep() const;

  protected:

    void Init();

    void Error(EErrorCodes a_iErrc, int a_iPos = static_cast<int>(mu::string_type::npos), const string_type& a_strTok = string_type()) const;

    virtual void InitCharSets() = 0;

    virtual void InitFun() = 0;

    virtual void InitConst() = 0;

    virtual void InitOprt() = 0;

    virtual void OnDetectVar(string_type* pExpr, int& nStart, int& nEnd);

    static const char_type* c_DefaultOprt[];

    static std::locale s_locale;  ///< The locale used by the parser

    static bool g_DbgDumpCmdCode;

    static bool g_DbgDumpStack;

    /** \brief A facet class used to change decimal and thousands separator. */

    template<class TChar>

    class change_dec_sep : public std::numpunct<TChar>

    {

    public:

      explicit change_dec_sep(char_type cDecSep, char_type cThousandsSep = 0, int nGroup = 3)

        :std::numpunct<TChar>()

        ,m_nGroup(nGroup)

        ,m_cDecPoint(cDecSep)

        ,m_cThousandsSep(cThousandsSep)

      {}

    protected:

      char_type do_decimal_point() const override

      {

        return m_cDecPoint;

      }

      char_type do_thousands_sep() const override

      {

        return m_cThousandsSep;

      }

      std::string do_grouping() const override

      {

        // fix for issue 4: https://code.google.com/p/muparser/issues/detail?id=4

        // courtesy of Jens Bartsch

        // original code:

        //        return std::string(1, (char)m_nGroup); 

        // new code:

        return std::string(1, (char)(m_cThousandsSep > 0 ? m_nGroup : CHAR_MAX));

      }

    private:

      int m_nGroup;

      char_type m_cDecPoint;

      char_type m_cThousandsSep;

    };

  private:

    void Assign(const ParserBase& a_Parser);

    void InitTokenReader();

    void ReInit() const;

    void AddCallback(const string_type& a_strName, const ParserCallback& a_Callback, funmap_type& a_Storage, const char_type* a_szCharSet);

    void ApplyRemainingOprt(std::stack<token_type>& a_stOpt, std::stack<token_type>& a_stVal) const;

    void ApplyBinOprt(std::stack<token_type>& a_stOpt, std::stack<token_type>& a_stVal) const;

    void ApplyIfElse(std::stack<token_type>& a_stOpt, std::stack<token_type>& a_stVal) const;

    void ApplyFunc(std::stack<token_type>& a_stOpt, std::stack<token_type>& a_stVal, int iArgCount) const;

    token_type ApplyStrFunc(const token_type& a_FunTok, const std::vector<token_type>& a_vArg) const;

    int GetOprtPrecedence(const token_type& a_Tok) const;

    EOprtAssociativity GetOprtAssociativity(const token_type& a_Tok) const;

    void CreateRPN() const;

    value_type ParseString() const;

    value_type ParseCmdCode() const;

    value_type ParseCmdCodeShort() const;

    value_type ParseCmdCodeBulk(int nOffset, int nThreadID) const;

    void  CheckName(const string_type& a_strName, const string_type& a_CharSet) const;

    void  CheckOprt(const string_type& a_sName, const ParserCallback& a_Callback, const string_type& a_szCharSet) const;

    void StackDump(const std::stack<token_type >& a_stVal, const std::stack<token_type >& a_stOprt) const;

    /** \brief Pointer to the parser function.

      Eval() calls the function whose address is stored there.

    */

    mutable ParseFunction  m_pParseFormula;

    mutable ParserByteCode m_vRPN;        ///< The Bytecode class.

    mutable stringbuf_type  m_vStringBuf; ///< String buffer, used for storing string function arguments

    stringbuf_type  m_vStringVarBuf;

    std::unique_ptr<token_reader_type> m_pTokenReader; ///< Managed pointer to the token reader object.

    funmap_type  m_FunDef;         ///< Map of function names and pointers.

    funmap_type  m_PostOprtDef;    ///< Postfix operator callbacks

    funmap_type  m_InfixOprtDef;   ///< unary infix operator.

    funmap_type  m_OprtDef;        ///< Binary operator callbacks

    valmap_type  m_ConstDef;       ///< user constants.

    strmap_type  m_StrVarDef;      ///< user defined string constants

    varmap_type  m_VarDef;         ///< user defind variables.

    bool m_bBuiltInOp;             ///< Flag that can be used for switching built in operators on and off

    string_type m_sNameChars;      ///< Charset for names

    string_type m_sOprtChars;      ///< Charset for postfix/ binary operator tokens

    string_type m_sInfixOprtChars; ///< Charset for infix operator tokens

    // items merely used for caching state information

    mutable valbuf_type m_vStackBuffer; ///< This is merely a buffer used for the stack in the cmd parsing routine

    mutable int m_nFinalResultIdx;

  };

} // namespace mu

#if defined(_MSC_VER)

  #pragma warning(pop)

#endif

#endif