lua5.1参考手册

1149

函数名称：lua_tolstring——从LUA堆栈获得一个字符串
函数原型：const char *lua_tolstring (lua_State *L, int index, size_t *len);
参数1：lua_State对象
参数2：在堆栈中的位置，-1为栈顶，1为栈底，堆栈的位置请自己百度
参数3：如果len不为NULL，则把字符串的长度写入len中
功能：把给定索引处的 Lua 值转换为一个 C 字符串。 如果 len 不为 NULL ， 它还把字符串长度设到 *len 中。 这个 Lua 值必须是一个字符串或是一个数字； 否则返回返回 NULL 。 如果值是一个数字， lua_tolstring 还会把堆栈中的那个值的实际类型转换为一个字符串。 （当遍历一张表的时候， 若把 lua_tolstring 作用在键上， 这个转换有可能导致 lua_next 弄错。）
返回值：

---

函数名称：lua_gettable ——从LUA堆栈取出一个数组的值并压入堆栈
函数原型：int lua_gettable (lua_State *L, int index);
参数1：lua_State对象
参数2：在堆栈中的位置，-1为栈顶，1为栈底，堆栈的位置请自己百度
功能： 把数组t[k] 的值压栈， 这里的 t 是指索引指向的值， 而 k 则是栈顶放的值。
返回值：压入值的类型。

---

函数名称：lua_pushnumber ——把一个值为 n 的浮点数压栈。
函数原型：void lua_pushnumber (lua_State *L, lua_Number n);
参数1：lua_State对象
参数2：一个值为 n 的浮点数压栈。
功能：一个值为 n 的浮点数压栈。
返回值：NULL

---

函数名称：lua_objlen（5.1）
函数原型：size_t lua_objlen (lua_State *L, int index);
参数1：lua_State对象
参数2：在堆栈中的位置，-1为栈顶，1为栈底，堆栈的位置请自己百度
功能：返回给定可接受索引处的值的“长度”：对于字符串，这是字符串长度；对于表，这是长度运算符（“#”）的结果；对于userdata，这是为userdata分配的内存块的大小；对于其他值，它是0。
返回值：

---

函数名称：lua_next ——把指定索引表中键值对应的值压栈
函数原型：int lua_next (lua_State *L, int index);
参数1：lua_State对象
参数2：在堆栈中的位置，-1为栈顶，1为栈底，堆栈的位置请自己百度
功能：从栈顶弹出一个键， 然后把索引指定的表中的一个键值对压栈 （弹出的键之后的 “下一” 对）。
返回值：如果表中以无更多元素， 那么 lua_next 将返回 0 （什么也不压栈）。

---