// // SqratScript: Script Compilation and Execution // // // Copyright (c) 2009 Brandon Jones // // This software is provided 'as-is', without any express or implied // warranty. In no event will the authors be held liable for any damages // arising from the use of this software. // // Permission is granted to anyone to use this software for any purpose, // including commercial applications, and to alter it and redistribute it // freely, subject to the following restrictions: // // 1. The origin of this software must not be misrepresented; you must not // claim that you wrote the original software. If you use this software // in a product, an acknowledgment in the product documentation would be // appreciated but is not required. // // 2. Altered source versions must be plainly marked as such, and must not be // misrepresented as being the original software. // // 3. This notice may not be removed or altered from any source // distribution. // #if !defined(_SCRAT_SCRIPT_H_) #define _SCRAT_SCRIPT_H_ #ifdef SQMOD_PLUGIN_API #include #else #include #include #endif // SQMOD_PLUGIN_API #include #include "sqratObject.h" namespace Sqrat { ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Helper class for managing Squirrel scripts ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// class Script : public Object { public: ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Default constructor /// /// \param v VM that the Script will be associated with /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// Script(HSQUIRRELVM v = DefaultVM::Get()) : Object(v, true) { } ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Sets up the Script using a string containing a Squirrel script /// /// \param script String containing a file path to a Squirrel script /// \param name Optional string containing the script's name (for errors) /// /// \remarks /// This function MUST have its Error handled if it occurred. /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// void CompileString(const string& script, const string& name = _SC("")) { if(!sq_isnull(obj)) { sq_release(vm, &obj); sq_resetobject(&obj); } #if !defined (SCRAT_NO_ERROR_CHECKING) if(SQ_FAILED(sq_compilebuffer(vm, script.c_str(), static_cast(script.size() /** sizeof(SQChar)*/), name.c_str(), true))) { SQTHROW(vm, LastErrorString(vm)); return; } #else sq_compilebuffer(vm, script.c_str(), static_cast(script.size() /** sizeof(SQChar)*/), name.c_str(), true); #endif sq_getstackobj(vm,-1,&obj); sq_addref(vm, &obj); sq_pop(vm, 1); } ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Sets up the Script using a string containing a Squirrel script /// /// \param script String containing a file path to a Squirrel script /// \param errMsg String that is filled with any errors that may occur /// \param name Optional string containing the script's name (for errors) /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// bool CompileString(const string& script, string& errMsg, const string& name = _SC("")) { if(!sq_isnull(obj)) { sq_release(vm, &obj); sq_resetobject(&obj); } #if !defined (SCRAT_NO_ERROR_CHECKING) if(SQ_FAILED(sq_compilebuffer(vm, script.c_str(), static_cast(script.size() /** sizeof(SQChar)*/), name.c_str(), true))) { errMsg = LastErrorString(vm); return false; } #else sq_compilebuffer(vm, script.c_str(), static_cast(script.size() /** sizeof(SQChar)*/), name.c_str(), true); #endif sq_getstackobj(vm,-1,&obj); sq_addref(vm, &obj); sq_pop(vm, 1); return true; } ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Sets up the Script using a file containing a Squirrel script /// /// \param path File path containing a Squirrel script /// /// \remarks /// This function MUST have its Error handled if it occurred. /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// void CompileFile(const string& path) { if(!sq_isnull(obj)) { sq_release(vm, &obj); sq_resetobject(&obj); } #if !defined (SCRAT_NO_ERROR_CHECKING) if(SQ_FAILED(sqstd_loadfile(vm, path.c_str(), true))) { SQTHROW(vm, LastErrorString(vm)); return; } #else sqstd_loadfile(vm, path.c_str(), true); #endif sq_getstackobj(vm,-1,&obj); sq_addref(vm, &obj); sq_pop(vm, 1); } ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Sets up the Script using a file containing a Squirrel script /// /// \param path File path containing a Squirrel script /// \param errMsg String that is filled with any errors that may occur /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// bool CompileFile(const string& path, string& errMsg) { if(!sq_isnull(obj)) { sq_release(vm, &obj); sq_resetobject(&obj); } #if !defined (SCRAT_NO_ERROR_CHECKING) if(SQ_FAILED(sqstd_loadfile(vm, path.c_str(), true))) { errMsg = LastErrorString(vm); return false; } #else sqstd_loadfile(vm, path.c_str(), true); #endif sq_getstackobj(vm,-1,&obj); sq_addref(vm, &obj); sq_pop(vm, 1); return true; } ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Runs the script /// /// \remarks /// This function MUST have its Error handled if it occurred. /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// void Run() { #if !defined (SCRAT_NO_ERROR_CHECKING) if(!sq_isnull(obj)) { SQRESULT result; SQInteger top = sq_gettop(vm); sq_pushobject(vm, obj); sq_pushroottable(vm); result = sq_call(vm, 1, false, true); sq_settop(vm, top); if(SQ_FAILED(result)) { SQTHROW(vm, LastErrorString(vm)); return; } } #else SQInteger top = sq_gettop(vm); sq_pushobject(vm, obj); sq_pushroottable(vm); sq_call(vm, 1, false, true); sq_settop(vm, top); #endif } #if !defined (SCRAT_NO_ERROR_CHECKING) ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Runs the script /// /// \param errMsg String that is filled with any errors that may occur /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// bool Run(string& errMsg) { if(!sq_isnull(obj)) { SQRESULT result; SQInteger top = sq_gettop(vm); sq_pushobject(vm, obj); sq_pushroottable(vm); result = sq_call(vm, 1, false, true); sq_settop(vm, top); if(SQ_FAILED(result)) { errMsg = LastErrorString(vm); return false; } return true; } return false; } #endif ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// /// Writes the byte code of the Script to a file /// /// \param path File path to write to /// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// void WriteCompiledFile(const string& path) { #if !defined (SCRAT_NO_ERROR_CHECKING) if(!sq_isnull(obj)) { sq_pushobject(vm, obj); sqstd_writeclosuretofile(vm, path.c_str()); } #else sq_pushobject(vm, obj); sqstd_writeclosuretofile(vm, path.c_str()); #endif sq_pop(vm, 1); // needed? } }; } #endif