#ifndef interpreter_hh #define interpreter_hh // interpreter.hh // marvin - programme du robot 2006. {{{ // // Copyright (C) 2006 Nicolas Schodet // // Robot APB Team/Efrei 2006. // Web: http://assos.efrei.fr/robot/ // Email: robot AT efrei DOT fr // // This program is free software; you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation; either version 2 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program; if not, write to the Free Software // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. // // }}} #include "utils/any.hh" #include class Interpreter { public: /// Function arguments. typedef any Arg; /// Function arguments list. typedef std::list Args; /// Functions must inherit from this type. class Func { public: /// Mandatory virtual destructor. virtual ~Func (void) { } /// Called on function invocation, getting the argument list and /// returning true on success. virtual void operator() (const Args &, bool dryrun) = 0; }; private: /// Func class construction helper. template class MemFunc; private: struct FuncDesc { Func *func; std::string desc; FuncDesc (Func *func_, const std::string &desc_) : func (func_), desc (desc_) { } }; /// Type of the private function map. typedef std::map Funcs; /// The function map itself. Funcs funcs_; public: /// Destructor. ~Interpreter (void); /// Add a function, Interpreter owns f. void add (const std::string &s, Func *f, const std::string &desc); /// Add a function without description, Interpreter owns f. void add (const std::string &s, Func *f); /// Test if a function is defined. bool exists (const std::string &s) const; /// Call a function by name. void call (const std::string &s, const Args &a, bool dryrun = false) const; /// Interpret a string. void interpretString (const std::string &s, bool dryrun = false); /// Interpret a file. void interpretFile (const std::string &file, bool dryrun = false); /// Return an help string. std::string help (void) const; /// Take all the template sophistications out of the programmer hands. template static Func *memFunc (T &i, F f); }; #include "interpreter.tcc" #endif // interpreter_hh