ScriptExecutor.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include "AstScript/Value.hpp"
#include <string>
#include <type_traits>
 
AST_NAMESPACE_BEGIN
 
enum class EScriptLanguage
{
    ePython,            
    eMATLAB,            
    eJavaScript,        
    eJScript,           
    eVBScript,          
    eJulia,             
    eLua,               
    eAstScript,         
};
 
 
AST_SCRIPT_API std::string toString(EScriptLanguage type);
 
class ScriptExecutor;
class Variable;
 
AST_SCRIPT_CAPI ScriptExecutor* aNewScriptExecutor(EScriptLanguage type);
 
 
class ScriptResult
{
public:
    const std::string& error() const { return error_; }
    Value* value() const { return value_.get(); }
 
    std::string error_{};         
    SharedPtr<Value> value_{};    
};
 
class AST_SCRIPT_API ScriptExecutor
{
public:
    virtual ~ScriptExecutor() = default;
 
    virtual errc_t initialize() = 0;
 
    virtual void finalize() = 0;
 
    virtual errc_t execute(StringView script, ScriptResult* resultOut=nullptr) = 0;
 
    virtual errc_t evaluate(StringView expression, ScriptResult* resultOut=nullptr);
 
 
    errc_t execute(StringView script, std::string* error);
 
 
    virtual std::string getLastError() const = 0;
 
    virtual errc_t setVariable(StringView name, StringView value) = 0;
    virtual errc_t setVariable(StringView name, double value) = 0;
    virtual errc_t setVariable(StringView name, int value) = 0;
    virtual errc_t setVariable(StringView name, bool value) = 0;
    errc_t setVariable(StringView name, const char* value){return setVariable(name, StringView(value));}
    errc_t setVariable(StringView name, const std::string& value){return setVariable(name, StringView(value));}
    errc_t setVariable(Variable* var);
 
    // 拦截 float、long、各种指针等无法匹配上述重载、却会被隐式转换悄悄接受下来的类型，让调用错误在编译期暴露出来
    // 注意：不能连可转换为 StringView 的类型一起拦。除了 std::string，
    //      SWIG 生成的包装代码会把参数写成 SwigValueWrapper<StringView>
    template <typename T, typename = typename std::enable_if<!std::is_convertible<T, StringView>::value>::type>
    errc_t setVariable(StringView name, T value) = delete;
 
    virtual errc_t getVariable(StringView name, std::string& value) const = 0;
    virtual errc_t getVariable(StringView name, double& value) const = 0;
    virtual errc_t getVariable(StringView name, int& value) const = 0;
    virtual errc_t getVariable(StringView name, bool& value) const = 0;
    errc_t getVariable(Variable* var);
};
 
 
AST_NAMESPACE_END