lua api 小记.docxVIP

《Lua API 小记》 转载自RingOfTheC[ring.of.the.c@] 一、第一部分(API) 这些东西是平时遇到的, 觉得有一定的价值, 所以记录下来, 以后遇到类似的问题可以查阅, 同时分享出来也能方便需要的人, 转载请注明来自RingOfTheC[ring.of.the.c@] 打算记录一些lua_api, 可能会觉得lua文档中已经说的很清楚了, 但是我将用自己的方式, 记录下我认为重要的东西, 先约定一下api说明的格式 编号. api作用简述 api函数原型 api操作说明 返回值说明 对栈的影响 注意事项 1. 建一个新表 void lua_createtable (lua_State *L, int narr, int nrec) 创建一个新的table, 并把它放在栈顶. narr和nrec分别指定该table的array部分和hash部分的预分配元素数量 无返回值 栈高度+1, 栈顶元素是新table #define lua_newtable(L) lua_createtable(L, 0, 0) 常用这个 2. 取表中的元素 void lua_getfield (lua_State *L, int index, const char *k) 操作: arr = Stack[index] // arr肯定是表 Stack.push( arr[k] ) 取表中键为k的元素, 这里的表是由index指向的栈上的一个表 无返回值 栈高度+1, 栈顶元素是(Stack[index])[k] 注意, 该操作将触发 __index 元方法 3. 给表中的元素赋值 void lua_setfield (lua_State *L, int index, const char *k) 操作: arr = Stack[index] arr[k] = Stack.top() Stack.pop() 给表中键为k的元素赋值value(value就是栈顶元素), 这里的表是由index指向的栈上的一个表 无返回值 栈高度-1, 被弹出的是value 注意, 该操作将触发 __newindex 元方法 4. 取表元素 和 表元素赋值 void lua_gettable (lua_State *L, int index) 操作: ele = Stack[index] key = Stack.top() Stack.pop() value = ele[key] Stack.push(value) 根据index指定取到相应的表; 取栈顶元素为key, 并弹出栈; 获取表中key的值压入栈顶. 无返回值 栈高度不变, 但是发生了一次弹出和压入的操作, 弹出的是key, 压入的是value 注意, 该操作将触发 __index 元方法 void lua_settable (lua_State *L, int index) 操作: ele = Stack[index] value = Stack.top() Stack.pop() key = Stack.top() Stack.pop() ele[key] = value 根据index指定取到相应的表; 取栈顶元素做value, 弹出之; 再取当前栈顶元素做key, 亦弹出之; 然后将表的键为key的元素赋值为value 无返回值 栈高度-2, 第一次弹出value, 第二次弹出key 注意, 该操作将触发 __newindex 元方法 5. 对table的一些操作[不引发原方法] void lua_rawget (lua_State *L, int index) 和lua_gettable操作一样 但是不触发相应的元方法 void lua_rawgeti(lua_State *L, int index, int n) 操作: ele = Stack[index] value = ele[n] Stack.push(value) 无返回值 栈+1， 栈顶新增元素就是 value 不触发相应的元方法 void lua_rawset (lua_State *L, int index) 和lua_settable操作一样 但是不触发相应的原方法 void lua_rawseti (lua_State *L, int index, int n) 操作: ele = Stack