OpenTTD/src/script/squirrel_std.hpp

61 lines
1.6 KiB
C++

/* $Id$ */
/** @file squirrel_std.hpp defines the Squirrel Standard Function class */
#ifndef SQUIRREL_STD_HPP
#define SQUIRREL_STD_HPP
#if defined(__APPLE__)
/* Which idiotic system makes 'require' a macro? :s Oh well.... */
#undef require
#endif /* __APPLE__ */
/**
* By default we want to give a set of standard commands to a SQ script.
* Most of them are easy wrappers around internal functions. Of course we
* could just as easy include things like the stdmath of SQ, but of those
* functions we are sure they work on all our supported targets.
*/
class SquirrelStd {
public:
/**
* Make an integer absolute.
*/
static SQInteger abs(HSQUIRRELVM vm);
/**
* Get the lowest of two integers.
*/
static SQInteger min(HSQUIRRELVM vm);
/**
* Get the highest of two integers.
*/
static SQInteger max(HSQUIRRELVM vm);
/**
* Load an other file on runtime.
* @note This is always loaded on the root-level, no matter where you call this.
* @note The filename is always relative from the script it is called from. Absolute calls are NOT allowed!
*/
static SQInteger require(HSQUIRRELVM vm);
/**
* Enable/disable stack trace showing for handled exceptions.
*/
static SQInteger notifyallexceptions(HSQUIRRELVM vm);
};
/**
* Register all standard functions we want to give to a script.
*/
void squirrel_register_std(Squirrel *engine);
/**
* Register all standard functions that are available on first startup.
* @note this set is very limited, and is only ment to load other scripts and things like that.
*/
void squirrel_register_global_std(Squirrel *engine);
#endif /* SQUIRREL_STD_HPP */