前言#

之前讲了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环境  

• 结果

ischeck.png

总结#

• 由前两条结果可知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不受到垃圾收集器的管理。