cocos2d-x lua绑定解析

2022-11-29 20:19:58

花了几天时间看了下cocos2d-x lua绑定那块，总算是基本搞明白了，下面分三部分解析lua绑定：

一、lua绑定主要用到的底层函数

lua绑定其本质就是有一个公用的lua_Stack来进行C和Lua之间的值传递，在路径[项目根目录]\frameworks\cocos2d-x\external\lua\luajit\include下有个lua.h文件，大部分lua绑定底层函数以及相关的常量都在这里。

1.lua堆栈常量

#define LUA_REGISTRYINDEX (-10000)　　//用于在C/C++中维持一些Lua对象
#define LUA_ENVIRONINDEX (-10001)　　 //C/C++函数环境索引
#define LUA_GLOBALSINDEX (-10002)　　//全局变量_G的索引

#define LUA_MINSTACK 20

2.基础堆栈操作函数

L是一个LIFO（先进后出）的堆栈，idx可以为负数，-1代表栈顶元素，以此类推

LUA_API int (lua_gettop) (lua_State *L);　　　　　　　　//获取栈顶元素的索引（值也等于堆栈中元素个数）
LUA_API void (lua_settop) (lua_State *L, int idx);　　　 //设置栈顶索引为idx，如果当前元素个数大于idx，则大于idx的元素被移除；如果当前元素个数小于idx，则用nil填充。另外，lua_settop(L, 0)用于清空堆栈。
LUA_API void (lua_pushvalue) (lua_State *L, int idx);　 //将堆栈中idx对应的元素拷贝一份到栈顶
LUA_API void (lua_remove) (lua_State *L, int idx);　　 //移除idx对应的元素，并将其上面的元素依次下移来填充空白。
LUA_API void (lua_insert) (lua_State *L, int idx);　　 //将栈顶元素插入到idx位置，原先在idx及上面的元素依次上移。
LUA_API void (lua_replace) (lua_State *L, int idx);　　 //将栈顶元素弹出，并替换掉idx位置的元素
LUA_API int (lua_checkstack) (lua_State *L, int sz);　　//检测堆栈剩余的空间是否大于sz

LUA_API void (lua_xmove) (lua_State *from, lua_State *to, int n);//从 from 的堆栈中弹出 n 个值，然后把它们压入 to 的堆栈中。

3.C访问堆栈函数(stack->C)

LUA_API int (lua_isnumber) (lua_State *L, int idx);　　 //判断是否是number类型
LUA_API int (lua_isstring) (lua_State *L, int idx);　　 //判断是否是string类型
LUA_API int (lua_iscfunction) (lua_State *L, int idx);　 //判断是否是CFunction类型
LUA_API int (lua_isuserdata) (lua_State *L, int idx);　　//判断是否是userdata类型

LUA_API lua_Number (lua_tonumber) (lua_State *L, int idx);　　　　　　//将堆栈元素转换为number类型
LUA_API lua_Integer (lua_tointeger) (lua_State *L, int idx);　　　　　　 //将堆栈元素转换为integer类型
LUA_API int (lua_toboolean) (lua_State *L, int idx);　　　　　　　　　　 //将堆栈元素转换为boolean类型
LUA_API const char *(lua_tolstring) (lua_State *L, int idx, size_t *len); //将堆栈元素转换为lstring类型
LUA_API size_t (lua_objlen) (lua_State *L, int idx);　　　　　　　　　　 //将堆栈元素转换为size类型
LUA_API lua_CFunction (lua_tocfunction) (lua_State *L, int idx);　　　　//将堆栈元素转换为CFunction类型
LUA_API void *(lua_touserdata) (lua_State *L, int idx);　　　　　　　　 //将堆栈元素转换为userdata类型

4.将C元素压入堆栈函数(C->stack)

LUA_API void (lua_pushnil) (lua_State *L);　　　　　　　　　　　　　　　　　　//向堆栈压入nil
LUA_API void (lua_pushnumber) (lua_State *L, lua_Number n);　　　　　　　 //向堆栈压入number类型
LUA_API void (lua_pushinteger) (lua_State *L, lua_Integer n);　　　　　　　　//向堆栈压入integer类型
LUA_API void (lua_pushlstring) (lua_State *L, const char *s, size_t l);　　　　 //向堆栈压入任意的char数组，允许包含'0'字符
LUA_API void (lua_pushstring) (lua_State *L, const char *s);　　　　　　　　　//向堆栈压入char数组，必须以'0'结束
LUA_API const char *(lua_pushfstring) (lua_State *L, const char *fmt, ...);　　//向堆栈压入fmt格式化后的string
LUA_API void (lua_pushcclosure) (lua_State *L, lua_CFunction fn, int n);　　　//向堆栈压入CFunction类型
LUA_API void (lua_pushboolean) (lua_State *L, int b);　　　　　　　　　　　　 //向堆栈压入boolean类型
LUA_API void (lua_pushlightuserdata) (lua_State *L, void *p);　　　　　　　　//向堆栈压入C指针的值

5.将堆栈元素存入lua表(stack->Lua)

LUA_API void (lua_settable) (lua_State *L, int idx);　　　　　　　　//向lua表存入table类型

e.g:
lua_pushnumber(L, 1);
lua_pushstring(L, "1");
lua_settable(L, -3);

LUA_API void (lua_setfield) (lua_State *L, int idx, const char *k);　//向lua表设置key-CFunction对

e.g:
lua_pushcfunction(L, l_sin);
lua_setfield(L, LUA_GLOBALSINDEX, "mysin");

LUA_API void (lua_rawset) (lua_State *L, int idx);　　　　　　　　//向lua表设置变量值

e.g:
lua_pushstring(L, "tolua_opened");
lua_pushboolean(L, 1);
lua_rawset(L, LUA_REGISTRYINDEX)

LUA_API void (lua_rawseti) (lua_State *L, int idx, int n);　　　　　//向lua表设置变量值，n作为key
e.g:

lua_pushstring(L, "1");
lua_rawseti(L, -2, 1);

等同于

lua_pushnumber(L, 1);

lua_pushstring(L, "1");

lua_settable(L, -3);

LUA_API int (lua_setmetatable) (lua_State *L, int objindex);　　　　//设置元表

e.g:
lua_createtable(L, 0, 0);//表A
lua_createtable(L, 0, 0);//表B
lua_pushnumber(L, 1);
lua_pushstring(L, "1");
lua_rawset(L, -3);
lua_setmetatable(L, -2);//表B成为表A的元表

6.从lua表中获取函数(Lua->stack)

作用是（5）中函数的逆运算，用法同上

LUA_API void (lua_gettable) (lua_State *L, int idx);　　　　　　　　　　
LUA_API void (lua_getfield) (lua_State *L, int idx, const char *k);　　
LUA_API void (lua_rawget) (lua_State *L, int idx);　　　　　　　　　　
LUA_API void (lua_rawgeti) (lua_State *L, int idx, int n);
LUA_API void (lua_createtable) (lua_State *L, int narr, int nrec);　　　　//新建一个lua表
LUA_API int (lua_getmetatable) (lua_State *L, int objindex);

二、lua绑定流程

1.C中注册类

在工程中新建了一个简单的类UNode，其中有2个主要方法create和getTag