Lua与C语言通信的主要方式是通过一个无所不在的虚拟栈。几乎所有的Api调用都会操作栈上的值,无论是Lua到C还是C到Lua都是通过这个栈来完成的.还可以使用栈来保存一些中间结果。栈可以解决Lua和C语言中的差异,第一是Lua中的垃圾回收收集,而C语言要求显式第释放内存;
Lua库中没有定义任何全局变量。他将所有的状态都保存在动态的结构lua_State中,所有的C API要求传入一个指向改结构的指针。例如函数:
lua_State *ls = luaStack->getLuaState();
lua_pushinteger(ls, 123);
lua_pushstring(ls, "agda");
无论是哪个函数都需要传入一个ls这样的指针.这样的实现方式可以使得Lua可以重入,可以用于多线程的代码中。
当创建好一个状态,在其中加载了标准库后,就可以解析用户的输入了。程序调用luaL_loadbuffer来编译用户输入的内容,如果没有错误就会返回0,并像栈中加入编译后的程序模块。然后程序调用lua_pcall,这个函数会将程序块弹出,并在保护状态下运行它。
lua_pushcfunction(ls, lua_error_handler);//将错误处理的函数压入栈
luaStack->pushFunctionByHandler(nHandler);//将函数压入栈
lua_pushinteger(ls, 123);//将第一个参数压入栈
lua_pushstring(ls, "agda");//将第二个参数压入栈
int number = lua_gettop(ls);//获取栈的参数个数
number = lua_pcall(ls, 2, 1, -4);//ls就是lua_State、2表示的是函数有两个参数、1表示返回值得个数、-4表示如果出现错误调用倒数第四个压入栈的函数
Lua API使用一个抽象的栈、在Lua和C语言中进行数据交换,栈中的每个元素都能保存任何类型的Lua值。要获取Lua中的一个值,只要调用Lua的Api函数,Lua就会指定的值压入栈中。要将一个值传给Lua是,需要先将一个值压入栈,然后调用LuaApi,Lua获取该值并将他从栈上弹出。
几乎所有的API函数都会用到这个栈。luaL_loadbuffer将他的结果(编译好的程序块或者错误消息)留在栈中;lua_pcall会调用栈中的一个函数,如果发生错误将错误信息放在栈汇中。
压入元素:
Lua中的C类型,API都有一个相对应的压入函数:
lua_pushnil(lua_State *l)
lua_pushboolean(lua_State * l, int bool)
lua_pushnumber(lua_State * l ,lua_number n)
and so on.
要注意的是这个函数:
lua_pushlstring(lua_State *l , const char * s, size, size_t len)//主要是压入二级制的数据可以带有'\0'
lua_pushstring(lua_State * l ,const char *s) //这个就是直接压入一个字符串
lua的战中至少会有20个空闲的槽。
lua_checkstack(lua_State *l, int sz)检测空间是否足够
查询数据:
第一个压入栈的索引为1,第二个为2
倒数第一个为-1,倒数第二个为-2
为了检测一个元素是否为某种类型可以使用函数:
lua_isnumber(lua_State *l , int index)
lua_isstring()
来进行判断
一般使用的是这个函数来进行类型的判断:
lua_type(lua_State *l ,int index)
返回的值一般有:1,2,3,4,5对应LUA_TNIL、LUA_TBOOLEAN
要获取某个slot的值,那么可以使用
lua_toboolean()
lua_tonumber()
lua_tostring()不正确也没有关系,要么他是返回0,要么返回的是NULL
lua_tolString
使用函数:
lua_gettop(lua_State *l)//可以获取栈的元素个数。获取最后一个压入栈的索引值。
lua_settop(lua_State * l ,index)//如果之前的栈顶比新的设置的高,那高出来的元素就丢弃了。有一个特例子lua_settop(L,0)那么就是清空栈。该函数lua_settop(l, -(n)-1)表示删除n个元素。
lua_pushvalue(lua_State*l ,index)