mirror of
https://github.com/lua/lua.git
synced 2024-11-24 10:43:44 +08:00
587 lines
12 KiB
C
587 lines
12 KiB
C
/*
|
|
** $Id: lapi.c,v 1.3 1997/10/24 17:17:24 roberto Exp roberto $
|
|
** Lua API
|
|
** See Copyright Notice in lua.h
|
|
*/
|
|
|
|
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#include "lapi.h"
|
|
#include "lauxlib.h"
|
|
#include "lbuiltin.h"
|
|
#include "ldo.h"
|
|
#include "lfunc.h"
|
|
#include "lgc.h"
|
|
#include "llex.h"
|
|
#include "lmem.h"
|
|
#include "lobject.h"
|
|
#include "lstring.h"
|
|
#include "ltable.h"
|
|
#include "ltm.h"
|
|
#include "lua.h"
|
|
#include "luadebug.h"
|
|
#include "lvm.h"
|
|
|
|
|
|
char lua_ident[] = "$Lua: " LUA_VERSION " " LUA_COPYRIGHT " $\n"
|
|
"$Autores: " LUA_AUTHORS " $";
|
|
|
|
|
|
|
|
TObject *luaA_Address (lua_Object o)
|
|
{
|
|
return Address(o);
|
|
}
|
|
|
|
|
|
void luaA_packresults (void)
|
|
{
|
|
luaV_pack(luaD_Cstack.lua2C, luaD_Cstack.num, luaD_stack.top);
|
|
incr_top;
|
|
}
|
|
|
|
|
|
int luaA_passresults (void)
|
|
{
|
|
luaD_checkstack(luaD_Cstack.num);
|
|
memcpy(luaD_stack.top, luaD_Cstack.lua2C+luaD_stack.stack,
|
|
luaD_Cstack.num*sizeof(TObject));
|
|
luaD_stack.top += luaD_Cstack.num;
|
|
return luaD_Cstack.num;
|
|
}
|
|
|
|
|
|
static void checkCparams (int nParams)
|
|
{
|
|
if (luaD_stack.top-luaD_stack.stack < luaD_Cstack.base+nParams)
|
|
lua_error("API error - wrong number of arguments in C2lua stack");
|
|
}
|
|
|
|
|
|
static lua_Object put_luaObject (TObject *o)
|
|
{
|
|
luaD_openstack((luaD_stack.top-luaD_stack.stack)-luaD_Cstack.base);
|
|
luaD_stack.stack[luaD_Cstack.base++] = *o;
|
|
return luaD_Cstack.base; /* this is +1 real position (see Ref) */
|
|
}
|
|
|
|
|
|
static lua_Object put_luaObjectonTop (void)
|
|
{
|
|
luaD_openstack((luaD_stack.top-luaD_stack.stack)-luaD_Cstack.base);
|
|
luaD_stack.stack[luaD_Cstack.base++] = *(--luaD_stack.top);
|
|
return luaD_Cstack.base; /* this is +1 real position (see Ref) */
|
|
}
|
|
|
|
|
|
lua_Object lua_pop (void)
|
|
{
|
|
checkCparams(1);
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
/*
|
|
** Get a parameter, returning the object handle or LUA_NOOBJECT on error.
|
|
** 'number' must be 1 to get the first parameter.
|
|
*/
|
|
lua_Object lua_lua2C (int number)
|
|
{
|
|
if (number <= 0 || number > luaD_Cstack.num) return LUA_NOOBJECT;
|
|
/* Ref(luaD_stack.stack+(luaD_Cstack.lua2C+number-1)) ==
|
|
luaD_stack.stack+(luaD_Cstack.lua2C+number-1)-luaD_stack.stack+1 == */
|
|
return luaD_Cstack.lua2C+number;
|
|
}
|
|
|
|
|
|
lua_Object lua_upvalue (int n)
|
|
{
|
|
TObject *f = luaD_stack.stack+luaD_Cstack.lua2C-1;
|
|
if (ttype(f) != LUA_T_MARK || n <= 0 || n > clvalue(f)->nelems)
|
|
return LUA_NOOBJECT;
|
|
if (ttype(protovalue(f)) != LUA_T_CPROTO) lua_error("BAD!!");
|
|
*luaD_stack.top = clvalue(f)->consts[n];
|
|
incr_top;
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
int lua_callfunction (lua_Object function)
|
|
{
|
|
if (function == LUA_NOOBJECT)
|
|
return 1;
|
|
else {
|
|
luaD_openstack((luaD_stack.top-luaD_stack.stack)-luaD_Cstack.base);
|
|
luaD_stack.stack[luaD_Cstack.base] = *Address(function);
|
|
return luaD_protectedrun(MULT_RET);
|
|
}
|
|
}
|
|
|
|
|
|
lua_Object lua_gettagmethod (int tag, char *event)
|
|
{
|
|
return put_luaObject(luaT_gettagmethod(tag, event));
|
|
}
|
|
|
|
|
|
lua_Object lua_settagmethod (int tag, char *event)
|
|
{
|
|
checkCparams(1);
|
|
luaT_settagmethod(tag, event, luaD_stack.top-1);
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
lua_Object lua_seterrormethod (void)
|
|
{
|
|
TObject temp = luaD_errorim;
|
|
checkCparams(1);
|
|
luaD_errorim = *(--luaD_stack.top);
|
|
return put_luaObject(&temp);
|
|
}
|
|
|
|
|
|
lua_Object lua_gettable (void)
|
|
{
|
|
checkCparams(2);
|
|
luaV_gettable();
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
lua_Object lua_rawgettable (void)
|
|
{
|
|
checkCparams(2);
|
|
if (ttype(luaD_stack.top-2) != LUA_T_ARRAY)
|
|
lua_error("indexed expression not a table in raw gettable");
|
|
else {
|
|
TObject *h = luaH_get(avalue(luaD_stack.top-2), luaD_stack.top-1);
|
|
--luaD_stack.top;
|
|
if (h != NULL)
|
|
*(luaD_stack.top-1) = *h;
|
|
else
|
|
ttype(luaD_stack.top-1) = LUA_T_NIL;
|
|
}
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
void lua_settable (void)
|
|
{
|
|
checkCparams(3);
|
|
luaV_settable(luaD_stack.top-3, 1);
|
|
}
|
|
|
|
|
|
void lua_rawsettable (void)
|
|
{
|
|
checkCparams(3);
|
|
luaV_settable(luaD_stack.top-3, 0);
|
|
}
|
|
|
|
|
|
lua_Object lua_createtable (void)
|
|
{
|
|
TObject o;
|
|
luaC_checkGC();
|
|
avalue(&o) = luaH_new(0);
|
|
ttype(&o) = LUA_T_ARRAY;
|
|
return put_luaObject(&o);
|
|
}
|
|
|
|
|
|
lua_Object lua_getglobal (char *name)
|
|
{
|
|
luaD_checkstack(2); /* may need that to call T.M. */
|
|
luaV_getglobal(luaS_new(name));
|
|
return put_luaObjectonTop();
|
|
}
|
|
|
|
|
|
lua_Object lua_rawgetglobal (char *name)
|
|
{
|
|
TaggedString *ts = luaS_new(name);
|
|
return put_luaObject(&ts->u.globalval);
|
|
}
|
|
|
|
|
|
void lua_setglobal (char *name)
|
|
{
|
|
checkCparams(1);
|
|
luaD_checkstack(2); /* may need that to call T.M. */
|
|
luaV_setglobal(luaS_new(name));
|
|
}
|
|
|
|
|
|
void lua_rawsetglobal (char *name)
|
|
{
|
|
TaggedString *ts = luaS_new(name);
|
|
checkCparams(1);
|
|
luaS_rawsetglobal(ts, --luaD_stack.top);
|
|
}
|
|
|
|
|
|
|
|
int lua_isnil (lua_Object o)
|
|
{
|
|
return (o!= LUA_NOOBJECT) && (ttype(Address(o)) == LUA_T_NIL);
|
|
}
|
|
|
|
int lua_istable (lua_Object o)
|
|
{
|
|
return (o!= LUA_NOOBJECT) && (ttype(Address(o)) == LUA_T_ARRAY);
|
|
}
|
|
|
|
int lua_isuserdata (lua_Object o)
|
|
{
|
|
return (o!= LUA_NOOBJECT) && (ttype(Address(o)) == LUA_T_USERDATA);
|
|
}
|
|
|
|
int lua_iscfunction (lua_Object o)
|
|
{
|
|
return (o != LUA_NOOBJECT) && (lua_tag(o) == LUA_T_CPROTO);
|
|
}
|
|
|
|
int lua_isnumber (lua_Object o)
|
|
{
|
|
return (o!= LUA_NOOBJECT) && (tonumber(Address(o)) == 0);
|
|
}
|
|
|
|
int lua_isstring (lua_Object o)
|
|
{
|
|
int t = lua_tag(o);
|
|
return (t == LUA_T_STRING) || (t == LUA_T_NUMBER);
|
|
}
|
|
|
|
int lua_isfunction (lua_Object o)
|
|
{
|
|
return (o != LUA_NOOBJECT) && ((ttype(Address(o)) == LUA_T_FUNCTION) ||
|
|
(ttype(Address(o)) == LUA_T_MARK));
|
|
}
|
|
|
|
|
|
real lua_getnumber (lua_Object object)
|
|
{
|
|
if (object == LUA_NOOBJECT) return 0.0;
|
|
if (tonumber (Address(object))) return 0.0;
|
|
else return (nvalue(Address(object)));
|
|
}
|
|
|
|
char *lua_getstring (lua_Object object)
|
|
{
|
|
if (object == LUA_NOOBJECT || tostring(Address(object)))
|
|
return NULL;
|
|
else return (svalue(Address(object)));
|
|
}
|
|
|
|
void *lua_getuserdata (lua_Object object)
|
|
{
|
|
if (object == LUA_NOOBJECT || ttype(Address(object)) != LUA_T_USERDATA)
|
|
return NULL;
|
|
else return tsvalue(Address(object))->u.d.v;
|
|
}
|
|
|
|
lua_CFunction lua_getcfunction (lua_Object object)
|
|
{
|
|
if (!lua_iscfunction(object))
|
|
return NULL;
|
|
else return fvalue(protovalue(Address(object)));
|
|
}
|
|
|
|
|
|
void lua_pushnil (void)
|
|
{
|
|
ttype(luaD_stack.top) = LUA_T_NIL;
|
|
incr_top;
|
|
}
|
|
|
|
void lua_pushnumber (real n)
|
|
{
|
|
ttype(luaD_stack.top) = LUA_T_NUMBER;
|
|
nvalue(luaD_stack.top) = n;
|
|
incr_top;
|
|
}
|
|
|
|
void lua_pushstring (char *s)
|
|
{
|
|
if (s == NULL)
|
|
ttype(luaD_stack.top) = LUA_T_NIL;
|
|
else {
|
|
tsvalue(luaD_stack.top) = luaS_new(s);
|
|
ttype(luaD_stack.top) = LUA_T_STRING;
|
|
}
|
|
incr_top;
|
|
luaC_checkGC();
|
|
}
|
|
|
|
void lua_pushCclosure (lua_CFunction fn, int n)
|
|
{
|
|
if (fn == NULL) {
|
|
ttype(luaD_stack.top) = LUA_T_NIL;
|
|
incr_top;
|
|
}
|
|
else {
|
|
checkCparams(n);
|
|
ttype(luaD_stack.top) = LUA_T_CPROTO;
|
|
fvalue(luaD_stack.top) = fn;
|
|
incr_top;
|
|
luaV_closure(n);
|
|
}
|
|
}
|
|
|
|
void lua_pushusertag (void *u, int tag)
|
|
{
|
|
if (tag < 0 && tag != LUA_ANYTAG)
|
|
luaT_realtag(tag); /* error if tag is not valid */
|
|
tsvalue(luaD_stack.top) = luaS_createudata(u, tag);
|
|
ttype(luaD_stack.top) = LUA_T_USERDATA;
|
|
incr_top;
|
|
luaC_checkGC();
|
|
}
|
|
|
|
void luaA_pushobject (TObject *o)
|
|
{
|
|
*luaD_stack.top = *o;
|
|
incr_top;
|
|
}
|
|
|
|
void lua_pushobject (lua_Object o)
|
|
{
|
|
if (o == LUA_NOOBJECT)
|
|
lua_error("API error - attempt to push a NOOBJECT");
|
|
*luaD_stack.top = *Address(o);
|
|
if (ttype(luaD_stack.top) == LUA_T_MARK)
|
|
ttype(luaD_stack.top) = LUA_T_FUNCTION;
|
|
incr_top;
|
|
}
|
|
|
|
|
|
int lua_tag (lua_Object lo)
|
|
{
|
|
if (lo == LUA_NOOBJECT) return LUA_T_NIL;
|
|
else {
|
|
TObject *o = Address(lo);
|
|
int t = luaT_efectivetag(o);
|
|
if (t == LUA_T_USERDATA)
|
|
return o->value.ts->u.d.tag;
|
|
else
|
|
return t;
|
|
}
|
|
}
|
|
|
|
|
|
void lua_settag (int tag)
|
|
{
|
|
checkCparams(1);
|
|
luaT_realtag(tag);
|
|
switch (ttype(luaD_stack.top-1)) {
|
|
case LUA_T_ARRAY:
|
|
(luaD_stack.top-1)->value.a->htag = tag;
|
|
break;
|
|
case LUA_T_USERDATA:
|
|
(luaD_stack.top-1)->value.ts->u.d.tag = tag;
|
|
break;
|
|
default:
|
|
luaL_verror("cannot change the tag of a %s",
|
|
luaO_typenames[-ttype((luaD_stack.top-1))]);
|
|
}
|
|
luaD_stack.top--;
|
|
}
|
|
|
|
|
|
/*
|
|
** =======================================================
|
|
** Debug interface
|
|
** =======================================================
|
|
*/
|
|
|
|
|
|
/* Hooks */
|
|
lua_CHFunction lua_callhook = NULL;
|
|
lua_LHFunction lua_linehook = NULL;
|
|
|
|
|
|
lua_Function lua_stackedfunction (int level)
|
|
{
|
|
StkId i;
|
|
for (i = (luaD_stack.top-1)-luaD_stack.stack; i>=0; i--)
|
|
if (luaD_stack.stack[i].ttype == LUA_T_MARK)
|
|
if (level-- == 0)
|
|
return Ref(luaD_stack.stack+i);
|
|
return LUA_NOOBJECT;
|
|
}
|
|
|
|
|
|
int lua_currentline (lua_Function func)
|
|
{
|
|
TObject *f = Address(func);
|
|
return (f+1 < luaD_stack.top && (f+1)->ttype == LUA_T_LINE) ? (f+1)->value.i : -1;
|
|
}
|
|
|
|
|
|
lua_Object lua_getlocal (lua_Function func, int local_number, char **name)
|
|
{
|
|
TObject *f = luaA_Address(func);
|
|
/* check whether func is a Lua function */
|
|
if (!(f->ttype == LUA_T_MARK || f->ttype == LUA_T_FUNCTION))
|
|
return LUA_NOOBJECT;
|
|
else {
|
|
TProtoFunc *fp = protovalue(f)->value.tf;
|
|
*name = luaF_getlocalname(fp, local_number, lua_currentline(func));
|
|
if (*name) {
|
|
/* if "*name", there must be a LUA_T_LINE */
|
|
/* therefore, f+2 points to function base */
|
|
return Ref((f+2)+(local_number-1));
|
|
}
|
|
else
|
|
return LUA_NOOBJECT;
|
|
}
|
|
}
|
|
|
|
|
|
int lua_setlocal (lua_Function func, int local_number)
|
|
{
|
|
TObject *f = Address(func);
|
|
TProtoFunc *fp = protovalue(f)->value.tf;
|
|
char *name = luaF_getlocalname(fp, local_number, lua_currentline(func));
|
|
checkCparams(1);
|
|
--luaD_stack.top;
|
|
if (name) {
|
|
/* if "name", there must be a LUA_T_LINE */
|
|
/* therefore, f+2 points to function base */
|
|
*((f+2)+(local_number-1)) = *luaD_stack.top;
|
|
return 1;
|
|
}
|
|
else
|
|
return 0;
|
|
}
|
|
|
|
|
|
void lua_funcinfo (lua_Object func, char **filename, int *linedefined)
|
|
{
|
|
TObject *f = Address(func);
|
|
if (!(ttype(f) == LUA_T_MARK || ttype(f) == LUA_T_FUNCTION))
|
|
lua_error("API - `funcinfo' called with a non-function value");
|
|
else {
|
|
f = protovalue(f);
|
|
if (ttype(f) == LUA_T_PROTO) {
|
|
*filename = tfvalue(f)->fileName->str;
|
|
*linedefined = tfvalue(f)->lineDefined;
|
|
}
|
|
else {
|
|
*filename = "(C)";
|
|
*linedefined = -1;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
static TObject *functofind;
|
|
static int checkfunc (TObject *o)
|
|
{
|
|
return (o->ttype == LUA_T_FUNCTION) &&
|
|
((functofind->ttype == LUA_T_FUNCTION) ||
|
|
(functofind->ttype == LUA_T_MARK)) &&
|
|
(functofind->value.cl == o->value.cl);
|
|
}
|
|
|
|
|
|
char *lua_getobjname (lua_Object o, char **name)
|
|
{ /* try to find a name for given function */
|
|
functofind = Address(o);
|
|
if ((*name = luaT_travtagmethods(checkfunc)) != NULL)
|
|
return "tag-method";
|
|
else if ((*name = luaS_travsymbol(checkfunc)) != NULL)
|
|
return "global";
|
|
else return "";
|
|
}
|
|
|
|
/*
|
|
** =======================================================
|
|
** BLOCK mechanism
|
|
** =======================================================
|
|
*/
|
|
|
|
#define MAX_C_BLOCKS 10
|
|
|
|
static int numCblocks = 0;
|
|
static struct C_Lua_Stack Cblocks[MAX_C_BLOCKS];
|
|
|
|
void lua_beginblock (void)
|
|
{
|
|
if (numCblocks >= MAX_C_BLOCKS)
|
|
lua_error("`lua_beginblock': too many nested blocks");
|
|
Cblocks[numCblocks] = luaD_Cstack;
|
|
numCblocks++;
|
|
}
|
|
|
|
void lua_endblock (void)
|
|
{
|
|
--numCblocks;
|
|
luaD_Cstack = Cblocks[numCblocks];
|
|
luaD_adjusttop(luaD_Cstack.base);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
int lua_ref (int lock)
|
|
{
|
|
int ref;
|
|
checkCparams(1);
|
|
ref = luaC_ref(luaD_stack.top-1, lock);
|
|
luaD_stack.top--;
|
|
return ref;
|
|
}
|
|
|
|
|
|
|
|
lua_Object lua_getref (int ref)
|
|
{
|
|
TObject *o = luaC_getref(ref);
|
|
return (o ? put_luaObject(o) : LUA_NOOBJECT);
|
|
}
|
|
|
|
|
|
void lua_open (void)
|
|
{
|
|
static int firsttime = 1;
|
|
if (!firsttime) return;
|
|
firsttime = 0;
|
|
luaS_init();
|
|
luaX_init();
|
|
luaT_init();
|
|
luaD_init();
|
|
luaB_predefine();
|
|
}
|
|
|
|
|
|
|
|
#if LUA_COMPAT2_5
|
|
/*
|
|
** API: set a function as a fallback
|
|
*/
|
|
|
|
static void do_unprotectedrun (lua_CFunction f, int nParams, int nResults)
|
|
{
|
|
StkId base = (luaD_stack.top-luaD_stack.stack)-nParams;
|
|
luaD_openstack(nParams);
|
|
luaD_stack.stack[base].ttype = LUA_T_CPROTO;
|
|
luaD_stack.stack[base].value.f = f;
|
|
luaF_simpleclosure(luaD_stack.stack+base);
|
|
luaD_call(base+1, nResults);
|
|
}
|
|
|
|
lua_Object lua_setfallback (char *name, lua_CFunction fallback)
|
|
{
|
|
lua_pushstring(name);
|
|
lua_pushcfunction(fallback);
|
|
do_unprotectedrun(luaT_setfallback, 2, 1);
|
|
return put_luaObjectonTop();
|
|
}
|
|
#endif
|
|
|