前言#
之前讲了lua_type和lua_typename的用法,可以用来查询变量值的类型,有时候可能不需要这么麻烦,我们的需求是仅仅要知道这个值是不是字符串。如果是的话,就打印出来,如果不是就什么也不做,要满足这个需求我们需要一个简单的api,其实判断一个值是不是特定类型的api是一个系列,他们统一命名为lua_isxxx,我们今天就来看看这“一群”api,大部分属于了解,只有个别几个用的多一些,我在例子里做了描述。
内容#
lua_isboolean##
- 原型:int lua_isboolean (lua_State *L, int index);
- 解释:当给定索引的值类型为 boolean 时,返回 1 ,否则返回 0 。
lua_iscfunction##
- 原型:int lua_iscfunction (lua_State *L, int index);
- 解释:当给定索引的值是一个 C 函数时,返回 1 ,否则返回 0 。
lua_isfunction##
- 原型:int lua_isfunction (lua_State *L, int index);
- 解释:当给定索引的值是一个 C 函数或 Lua 函数时,返回 1 ,否则返回 0 。
lua_islightuserdata##
- 原型:int lua_islightuserdata (lua_State *L, int index);
- 解释:当给定索引的值是一个 light userdata 时,返回 1 ,否则返回 0 。
lua_isnil##
- 原型:int lua_isnil (lua_State *L, int index);
- 解释:当给定索引的值是 nil 时,返回 1 ,否则返回 0 。
lua_isnumber##
- 原型:int lua_isnumber (lua_State *L, int index);
- 解释:当给定索引的值是一个数字,或是一个可转换为数字的字符串时,返回 1 ,否则返回 0 。
lua_isstring##
- 原型:int lua_isstring (lua_State *L, int index);
- 解释:当给定索引的值是一个字符串或是一个数字时,返回 1 ,否则返回 0 。
lua_istable##
- 原型:int lua_istable (lua_State *L, int index);
- 解释:当给定索引的值是一个 table 时,返回 1 ,否则返回 0 。
lua_isthread##
- 原型:int lua_isthread (lua_State *L, int index);
- 解释:当给定索引的值是一个 thread 时,返回 1 ,否则返回 0 。
lua_isuserdata##
- 原型:int lua_isuserdata (lua_State *L, int index);
- 解释:当给定索引的值是一个完整的 userdata 或是 light userdata 时,返回 1 ,否则返回 0 。
Usage##
- 首先我们来新建一个文件,将文件命名为ischeck.lua编写如下代码:
-- 定义一个table
information =
{
name = "tom",
age = 18,
sex = "man",
}
function func_testtype()
print("lua -- > test type")
end
- 接下来我们来编写c++调用的代码:
lua_State *L = lua_open();
luaL_openlibs(L);
luaL_dofile(L,"ischecktest.lua"); // 加载执行lua文件
lua_getglobal(L, "func_testtype"); // 函数入栈
if(lua_isfunction(L, -1)) // -->lua_isfunction用法
{
printf("c++ --> stack pos %d : is function\n", lua_gettop(L));
}
if(!lua_iscfunction(L, -1)) // -->lua_iscfunction用法
{
printf("c++ --> stack pos %d : is not c function\n", lua_gettop(L));
}
lua_getglobal(L,"information"); // 将全局表压入栈
if(lua_istable(L, -1)) // -->lua_istable用法
{
printf("c++ --> stack pos %d : is table\n", lua_gettop(L));
}
lua_pushboolean(L, true);
if(lua_isboolean(L, -1)) // -->lua_isboolean用法
{
printf("c++ --> stack pos %d : is boolean\n", lua_gettop(L));
}
lua_pushstring(L, "123");
if(lua_isstring(L, -1)) // -->lua_isstring用法
{
printf("c++ --> stack pos %d : is string\n", lua_gettop(L));
}
if(lua_isnumber(L, -1)) // -->lua_isnumber用法
{
printf("c++ --> stack pos %d : is number\n", lua_gettop(L));
}
lua_pushnil(L);
if(lua_isnil(L, -1)) // -->lua_isnil用法
{
printf("c++ --> stack pos %d : is nil\n", lua_gettop(L));
}
lua_close(L); //关闭lua环境
- 结果
总结#
- 由前两条结果可知func_testtype是从lua中读取的方法,而不是一个c方法,实际情况也是这样的。
- 从结果可以看到栈上第四个元素既是number又是string,由代码可知栈上第4个元素是“123”,原本是一个字符串,但是也可以转化为数字,所以看到结果你也就不奇怪了。
- lua_isstring函数针对于所有的数字也是返回1的,因为所有的数字都可以转化为字符串。
- 前面提到的userdata其实叫做“full userdata”,还有一种轻量级userdata被叫做“light userdata”是一种表示C指针的值(即void *)。由于它是一个值,所以不用创建它。要将一个轻量级userdata放入栈中,只需要调用lua_pushlightuserdata即可。
- 虽然两种userdata在名称上差不多,但它们之间还是存在很大不同的。轻量级userdata不是缓冲,只是一个指针而已。它也没有元表,就像数字一样,轻量级userdata不受到垃圾收集器的管理。