Lua `lua_touserdata` 函数详解：获取用户数据指针

以下是 Lua lua_touserdata 函数的源代码，该函数用于从给定索引处获取指向用户数据的指针：

void *lua_touserdata(lua_State *L, int idx) {
  TValue *o = index2addr(L, idx);
  switch (ttype(o)) {
    case LUA_TUSERDATA: return getudatamem(o);
    case LUA_TLIGHTUSERDATA: return pvalue(o);
    default: {
      const char *msg = lua_pushfstring(L, 'userdata expected, got %s', luaL_typename(L, idx));
      luaL_argerror(L, idx, msg);
      return NULL;  /* unreachable */
    }
  }
}

该函数的作用是从给定索引处获取一个指向用户数据的指针，并返回该指针。如果给定索引处的值不是一个用户数据，则会抛出一个错误。

函数参数说明

L: Lua 状态机指针
idx: 栈索引，可以是任意有效的栈索引

函数返回值

函数的返回值是一个指向用户数据的指针，或者在给定索引处的值不是一个用户数据时抛出错误。

函数实现原理

函数的实现非常简单，它只是检查给定索引处的值的类型，并根据类型返回相应的指针或抛出错误。

用户数据 (LUA_TUSERDATA)：如果给定索引处的值是一个用户数据，则它会调用 getudatamem 函数来获取用户数据的指针。
轻量级用户数据 (LUA_TLIGHTUSERDATA)：如果给定索引处的值是一个轻量级用户数据，则它会直接获取该值的指针，并将其作为用户数据的指针返回。
其他类型: 如果给定索引处的值不是用户数据，则会抛出一个错误，指出期望的类型是用户数据。

通过 lua_touserdata 函数，我们可以方便地从 Lua 栈中获取指向用户数据的指针，这在实现 C 扩展或进行底层操作时非常有用。