fish-shell/muparser-2.2.5/include/muParserTokenReader.h

/*
                 __________
    _____   __ __\______   \_____  _______  ______  ____ _______
   /     \ |  |  \|     ___/\__  \ \_  __ \/  ___/_/ __ \\_  __ \
  |  Y Y  \|  |  /|    |     / __ \_|  | \/\___ \ \  ___/ |  | \/
  |__|_|  /|____/ |____|    (____  /|__|  /____  > \___  >|__|
        \/                       \/            \/      \/
  Copyright (C) 2004-2013 Ingo Berg

  Permission is hereby granted, free of charge, to any person obtaining a copy of this
  software and associated documentation files (the "Software"), to deal in the Software
  without restriction, including without limitation the rights to use, copy, modify,
  merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
  permit persons to whom the Software is furnished to do so, subject to the following conditions:

  The above copyright notice and this permission notice shall be included in all copies or
  substantial portions of the Software.

  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
  NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/

#ifndef MU_PARSER_TOKEN_READER_H
#define MU_PARSER_TOKEN_READER_H

#include <cassert>
#include <cstdio>
#include <cstring>
#include <list>
#include <map>
#include <memory>
#include <stack>
#include <string>

#include "muParserDef.h"
#include "muParserToken.h"

/** \file
    \brief This file contains the parser token reader definition.
*/

namespace mu {
// Forward declaration
class ParserBase;

/** \brief Token reader for the ParserBase class.
*/
class ParserTokenReader final {
   private:
    typedef ParserToken<value_type, string_type> token_type;

   public:
    ParserTokenReader(ParserBase *a_pParent);

    void AddValIdent(identfun_type a_pCallback);
    void SetVarCreator(facfun_type a_pFactory, void *pUserData);
    void SetFormula(const string_type &a_strFormula);
    void SetArgSep(char_type cArgSep);

    int GetPos() const;
    const string_type &GetExpr() const;
    char_type GetArgSep() const;

    void IgnoreUndefVar(bool bIgnore);
    void ReInit();
    token_type ReadNextToken();

    /// \return the first error (if any), clearing it.
    OptionalError acquireFirstError() {
        OptionalError ret = std::move(firstError_);
        firstError_ = OptionalError{};
        return ret;
    }

   private:
    /** \brief Syntax codes.

              The syntax codes control the syntax check done during the first time parsing of
        the expression string. They are flags that indicate which tokens are allowed next
        if certain tokens are identified.
        */
    enum ESynCodes {
        noBO = 1 << 0,       ///< to avoid i.e. "cos(7)("
        noBC = 1 << 1,       ///< to avoid i.e. "sin)" or "()"
        noVAL = 1 << 2,      ///< to avoid i.e. "tan 2" or "sin(8)3.14"
        noVAR = 1 << 3,      ///< to avoid i.e. "sin a" or "sin(8)a"
        noARG_SEP = 1 << 4,  ///< to avoid i.e. ",," or "+," ...
        noFUN = 1 << 5,      ///< to avoid i.e. "sqrt cos" or "(1)sin"
        noOPT = 1 << 6,      ///< to avoid i.e. "(+)"
        noPOSTOP = 1 << 7,   ///< to avoid i.e. "(5!!)" "sin!"
        noINFIXOP = 1 << 8,  ///< to avoid i.e. "++4" "!!4"
        noEND = 1 << 9,      ///< to avoid unexpected end of formula
        noSTR = 1 << 10,     ///< to block numeric arguments on string functions
        noASSIGN = 1 << 11,  ///< to block assignement to constant i.e. "4=7"
        noIF = 1 << 12,
        noELSE = 1 << 13,
        sfSTART_OF_LINE = noOPT | noBC | noPOSTOP | noASSIGN | noIF | noELSE | noARG_SEP,
        noANY = ~0  ///< All of he above flags set
    };

    ParserTokenReader(const ParserTokenReader &a_Reader) = delete;
    ParserTokenReader &operator=(const ParserTokenReader &a_Reader) = delete;

    void SetParent(ParserBase *a_pParent);
    int ExtractToken(const char_type *a_szCharSet, string_type &a_strTok, int a_iPos) const;
    int ExtractOperatorToken(string_type &a_sTok, int a_iPos) const;

    bool IsBuiltIn(token_type &a_Tok);
    bool IsArgSep(token_type &a_Tok);
    bool IsEOF(token_type &a_Tok);
    bool IsInfixOpTok(token_type &a_Tok);
    bool IsFunTok(token_type &a_Tok);
    bool IsPostOpTok(token_type &a_Tok);
    bool IsOprt(token_type &a_Tok);
    bool IsValTok(token_type &a_Tok);
    bool IsVarTok(token_type &a_Tok);
    bool IsStrVarTok(token_type &a_Tok);
    bool IsUndefVarTok(token_type &a_Tok);
    bool IsString(token_type &a_Tok);
    bool Error(EErrorCodes a_iErrc, int a_iPos = -1, const string_type &a_sTok = string_type());

    token_type &SaveBeforeReturn(const token_type &tok);

    ParserBase *m_pParser;
    string_type m_strFormula;
    int m_iPos = 0;
    int m_iSynFlags = 0;
    bool m_bIgnoreUndefVar = false;

    OptionalError firstError_;  /// The first error reported during parsing.
    const funmap_type *m_pFunDef = nullptr;
    const funmap_type *m_pPostOprtDef = nullptr;
    const funmap_type *m_pInfixOprtDef = nullptr;
    const funmap_type *m_pOprtDef = nullptr;
    const valmap_type *m_pConstDef = nullptr;
    const strmap_type *m_pStrVarDef = nullptr;
    varmap_type *m_pVarDef = nullptr;  ///< The only non const pointer to parser internals
    facfun_type m_pFactory = nullptr;
    void *m_pFactoryData = nullptr;
    std::list<identfun_type> m_vIdentFun;  ///< Value token identification function
    varmap_type m_UsedVar;
    value_type m_fZero = 0;  ///< Dummy value of zero, referenced by undefined variables
    int m_iBrackets = 0;
    token_type m_lastTok;
    char_type m_cArgSep = ',';  ///< The character used for separating function arguments
};
}  // namespace mu

#endif