Lua C API 中的 lua_rawseti 与 lua_rawgeti 介绍

在 Lua 的 C API 中，lua_rawseti 和 lua_rawgeti 是两个用于直接操作表中整数键的函数。它们不触发元表机制，执行的是“原始”的读写操作，常用于性能敏感或需要绕过元方法的场景。

---

一、函数原型

void lua_rawseti (lua_State *L, int index, lua_Integer n);
void lua_rawgeti (lua_State *L, int index, lua_Integer n);

• L：Lua 状态机。
• index：栈中表的位置（可以是正数、负数或伪索引如 LUA_REGISTRYINDEX）。
• n：整数键，通常从 1 开始（Lua 数组惯例），但也支持 0、负数或大整数。

---

二、功能说明

✅ lua_rawseti(L, index, n)

• 将栈顶的值赋给表的第 n 个位置：table[n] = value
• 赋值后弹出栈顶的值
• 不触发 __newindex

示例：

lua_newtable(L);              // 创建表 → 栈顶
lua_pushstring(L, "hello");   // 压入值 → 栈顶是 "hello"，表在 -2
lua_rawseti(L, -2, 1);        // table[1] = "hello"，弹出 "hello"

✅ lua_rawgeti(L, index, n)

• 从表中取出第 n 个值，并压入栈顶
• 不触发 __index

示例（接上一个例子）：

lua_rawgeti(L, -1, 1);        // 取 table[1]，压入栈顶
const char* s = lua_tostring(L, -1);  // 得到 "hello"，将 Lua 栈上的某个值转换为 C 风格的字符串（const char*）
lua_pop(L, 1);                // 清理栈顶，从 Lua 栈（Lua Stack）的顶部移除指定数量的元素。

---

三、关键特性

特性	说明
🔁 不触发元表	绕过 __index / __newindex，适合在元方法内部安全操作表
🎯 仅支持整数键	如需字符串或其他类型键，请使用 lua_rawget / lua_rawset
🧱 动态扩展表	即使键 n 原本不存在，也会自动创建，不会报错
⚡ 性能略优	无元表查找开销，适合高频数组操作
📦 常用注册表操作	配合 luaL_ref 使用，存取引用编号：lua_rawgeti(L, LUA_REGISTRYINDEX, ref)

---

四、典型使用场景

1. 在 __index / __newindex 元方法中操作表
   → 避免递归调用。
2. 操作注册表中的引用
   → luaL_ref 返回整数，用 lua_rawgeti 取回。
3. 高效访问数组型数据结构
   → 如向量、列表、缓冲区等。
4. 实现内部缓存或索引结构
   → 用整数 ID 快速存取，避免字符串查找。

---

五、注意事项

• ✅ 栈操作要小心：rawseti 会弹出栈顶值，rawgeti 会压入值 —— 注意栈平衡。
• ✅ 键从 1 开始是惯例，但非强制；n=0、n=-1 也可用，但需明确意图。
• ❌ 不要用于非表对象：若 index 不指向表，会报类型错误。
• ❌ 不适用于字符串键：请用 lua_rawset / lua_rawget。

---

六、对比其他函数

函数	触发元表？	键类型	用途
lua_gettable / lua_settable	✅ 是	任意	普通表访问
lua_rawget / lua_rawset	❌ 否	任意	绕过元表，任意键
lua_rawgeti / lua_rawseti	❌ 否	整数	绕过元表，数组访问，性能更优

---

七、总结

• lua_rawgeti / lua_rawseti 是专为整数键设计的原始表操作函数。
• 它们安全、高效、稳定，是 Lua C API 中最常用的基础工具之一。
• 无论目标键是否存在，操作都不会报错 —— Lua 表会自动扩展。
• 在元表操作、注册表管理、数组处理等场景中不可或缺。