LuaInterpreter.h

/*
This file is part of the Lua_icxx library. 
Copyright 2010 (c) by Oliver Schoenborn. 
License terms in LICENSE.txt.
*/


#ifndef LUA_ICXX_INTERP_INCLUDED
#define LUA_ICXX_INTERP_INCLUDED


// Only tested with Lua 5.1

#include <string>
#include <cassert>
#include <lua.hpp>

#include "lua_icxx_export.h"
#include "LuaTempResult.h"
#include "LuaObjRef.h"
class LuaFuncRef;


class LUA_ICXX_CPP_API 
LuaInterpreter
{
public: // construct/destroy

    LuaInterpreter();

    LuaInterpreter(lua_State* lua): mLua(lua), mOwner(false) {}
    ~LuaInterpreter();

public: // methods


    LuaTempResult eval(const std::string& expr);
    LuaTempResult operator()(const std::string& expr);

    LuaTempResult eval(const std::string& expr, const LuaTableRef& globalEnv);
    LuaTempResult operator()(const std::string& expr, const LuaTableRef& globalEnv);

private:
    LuaTempResult doStringCommon( const std::string& script, const LuaTableRef * globalEnv = NULL);
    LuaTempResult doFileCommon( const std::string& script, const LuaTableRef * globalEnv = NULL);

public:


    LuaTempResult doString(const std::string& script);
    LuaTempResult doFile(const std::string& filename) { return doFileCommon(filename); }
    LuaTempResult doString(const std::string& script, const LuaTableRef& globalEnv);
    LuaTempResult doFile(const std::string& filename, const LuaTableRef& globalEnv);

    LuaTempResult chunkFromString(const std::string& script);
    LuaTempResult chunkFromFile(const std::string& filename);
    //LuaTempResult loadString(const std::string& script, const LuaTableRef& globalEnv);
    //LuaTempResult loadFile(const std::string& script, const LuaTableRef& globalEnv);

    template <typename TT> void setGlobal(const std::string& name, const TT& item);
    LuaTempResult getGlobal(const std::string& name);
    LuaTempResult newTable();

    LuaTempResult openDynLib(const std::string& libPath, const std::string& entryPoint);
    LuaTempResult require(const std::string& moduleName);

public: // methods to use Lua C API directly


    lua_State* getLuaState() const { return mLua; }
    operator lua_State*() const { return mLua; }

private: // methods

    LuaErrCode tryOpenDynLib( 
        const LuaFuncRef&, const std::string&, const std::string&, std::string& errMsg );

private: // data

    lua_State * mLua;
    bool mOwner;
};


inline LuaTempResult 
LuaInterpreter::eval( const std::string& expr )
{
    return doStringCommon("return " + expr);
}


inline LuaTempResult 
LuaInterpreter::eval( const std::string& expr, const LuaTableRef& globalEnv )
{
    return doStringCommon("return " + expr, & globalEnv);
}


inline LuaTempResult 
LuaInterpreter::operator()( const std::string& expr )
{
    return eval(expr);
}


inline LuaTempResult 
LuaInterpreter::operator()( const std::string& expr, const LuaTableRef& globalEnv )
{
    return eval(expr, globalEnv);
}


inline LuaTempResult 
LuaInterpreter::doString( const std::string& script )
{
    return doStringCommon(script);
}


inline LuaTempResult 
LuaInterpreter::doString( const std::string& script, const LuaTableRef& globalEnv )
{
    return doStringCommon(script, & globalEnv);
}


inline LuaTempResult 
LuaInterpreter::doFile( const std::string& filename, const LuaTableRef& globalEnv )
{
    return doFileCommon(filename, & globalEnv);
}


inline LuaTempResult 
LuaInterpreter::require( const std::string& moduleName )
{
    return eval( "require('" + moduleName + "')" );
}


template <typename TT>
inline void 
LuaInterpreter::setGlobal( const std::string& name, const TT& item )
{
    pushValToStack(mLua, item);
    lua_setglobal(mLua, name.c_str());
}


inline LuaTempResult 
LuaInterpreter::getGlobal( const std::string& name )
{
    const int stackTop = lua_gettop(mLua);
    assert( lua_checkstack(mLua, 1) ); 
    lua_getglobal(mLua, name.c_str());
    return LuaTempResult(mLua, stackTop);
}


inline LuaTempResult 
LuaInterpreter::newTable()
{
    const int stackTop = lua_gettop(mLua);
    assert( lua_checkstack(mLua, 1) ); 
    lua_newtable(mLua);
    return LuaTempResult(mLua, stackTop);
}

#endif // LUA_ICXX_INTERP_INCLUDED