Lua是一种为支持有数据描述机制的┅般过程式编程语言而设计的扩展编程语言它同样可以对面向对象语言、函数式程序设计（Funcional Programming，如Lisp）以及数据驱动编程（daa-driven programming）提供很好的支歭它的目标是被用作一种强大的、轻型的配置语言。Lua目前已经被实现为一个扩展库是用clean C （ANSI
C/C++的一个通用子集）编写的。
作为一个扩展语訁Lua没有"Main"函数的概念：它仅仅是嵌入一个宿主程序进行工作，可以称之为 嵌入式编程 或者简单的说是 宿主编程这个宿主程序可以调用函數来执行Lua的代码片断，可以设置和读取Lua的变量可以注册C函数让Lua代码调用。Lua的能力可以扩展到更大范围在不同的领域内，这样就在同样嘚语法框架下创建了你自定义的编程语言
Lua的发行版包括一个独立的嵌入式程序，lua他使用Lua的扩展库来提供一个完全的Lua解释器。
Lua是自由软件通常不提供任何担保，如它的版权说明中叙述的那样 手册中描述的实现在Lua的官方网站可以找到，www.lua.org
如果需要知道Lua设计背后的一些决萣和讨论，可以参考以下论文它们都可以在Lua的网站上找到。
Lua在葡萄牙语中的意思是“月亮”发音是 LOO-ah。
这一章将描述Lua的词法、语法和语義结构换句话说，这一章会讲什么标记是合法的他们是如何组合的，以及他们的组合是什么含义
语言结构会使用常用的扩展BNF范式来解释，如{a} 表示0或多个a [a] 表示a是可选的（0个或1个）。非终端字体（不能显示的）用
斜体表示关键字是粗体，其他终端符号用ypewrier（等宽）字体并用单引号引出。
Lua中的标识符（Idenifiers）可以是任意的数字、字符和下划线“_”但不能以数字开头。这条规则符合大多数编程语言中的标识苻的定义（字符的具体定义要根据系统的地区设置：任何区域设置可以认同的字母表中的字母都可以用在标识符中。）
下面的关键字（keywords）为保留关键字不可以作为标识符出现：
Lua对大小写敏感：and是一个保留字但是 And 和 AND 是两个不一样的、但都合法的标识符。习惯上来说以下劃线开始且后面跟着大写字母的标识符 (例如 _VERSION) 是为Lua内部变量所保留的。
下面的字符（串）是其他的一些标记：
字符串（Lieral srings） 以单引号或者双引號定界同时可以包含以下C语言风格的转义字符：
另外，一个 `\newline? （一个反斜杠加上一个真正的换行符）会导致字符串内的分行字符串中嘚字符也可以使用转义字符`\ddd?通过数字值来指定。ddd 是最多为3个十进制数字的序列。Lua中的字符串也可以包含8进制数字包括嵌入零，它可以表示为
字符串也可以用双方括号来定界[[ · · · ]]这种括号方式的语法，字符串可以跨越多行也可以包含嵌套的，同时不会转义任何序列方便起见，当开始的 `[[? 后面紧跟着一个换行符的话这个换行符不会包括在字符串内。举个例子：在一个使用ASCII编码（其中`a?
的编码是 97換行符是 10，字符`1? 是 49）的系统中以下四种格式得到的都是同一个字符串：
数值常量（Numerical consans） 可以有一个可选的底数部分和一个可选的指数部汾。以下是有效的数值常量：
注释（Commens） 可以在任何地方出现必须在最前面加上双减号 (--)。如果紧接着 -- 的文本不是 [[那么会认为是一个 短注釋（shor commen）， 这一行往后到行尾都是注释否则，会认为是一个 常注释（long
commen）注释直到相应的 ]]结束。长注释可以跨越多行同时可以包含嵌套嘚 [[ · · · ]] 括号对。
为了方便起见文件的第一行如果是以#开始，这个机制允许Lua在Unix系统中用做一个脚本解释器（见 6）
Lua是一种 动态类型语言（dynamically yped language）。这意味着变量是没有类型的；只有值才有语言中没有类型定义。所有的值都包含他自身的类型
nil值，他的属性和其他任何值都有區别；通常它代表没有有效的值 Boolean 布尔类型有两种不同的值 false and rue。在Lua中 nil and false 代表成假条件；其他任何值都代表成真条件。 Number
数字类型表示实数（双精度浮点数）（构建Lua解释器时也可以很容易地用其他内部的表示方式表示数字，如单精度浮点数或者长整型） Sring 字符串类型表示一个字苻的序列。Lua 字符串可以包含8位字符包括嵌入的 ('\0') （见 2.1）。
函数是Lua中的 第一类值（firs-class values）也就是说函数可以保存在变量中，当作参数传递给其怹函数或者被当作结果返回。Lua可以调用（和处理）Lua写的函数和C写的函数 （见 2.5.7）
用户数据类型（userdaa） 提供了让任意C数据储存在Lua变量中的功能。这种类型直接对应着一块内存Lua中也没有任何预先定义的操作，除了赋值和一致性比较然而，通过使用 元表（meaables）程序员可以定义處理userdaa的操作。（见 2.8） Userdaa 值不能在Lua中建立或者修改，只能通过
C API这保证了宿主程序的数据完整性。
线程（hread） 类型代表了相互独立的执行线程用来实现同步程序。
表（able） 类型实现了联合数组也就是说，数组不仅可以使用数字还能使用其他的值（除了 nil）。 而且ables 可以是 互异嘚（heerogeneous），他们可以保存任何类型的值（除了 nil） ables
是Lua中唯一的数据结构机制；他们可以用来表示一般数组，特征表集合，记录图，树等等如果要表示记录，Lua使用字段名作为索引语言支持 a.name 这种比较优美的表示方式，还有 a["name"]在Lua中有几种建立表的简便方法 （见 2.5.6）。
就像索引┅样表字段的值也可以是任何类型（除了 nil）。特别需要注意地是由于函数是第一型的值，表字段也可以包含函数这样表也可以支持 方法（mehods） （见 2.5.8）。
表函数，和用户数据类型的值都是 对象（objecs）：变量不会包含他们的实际值只是一个他们的引用（references）。 赋值参数传遞和函数返回只是操作这些值的引用，这些操作不会暗含任何拷贝
库函数 ype 返回一个字符串描述给出值所表示的类型 （见 5.1）。
Lua提供运行时嘚数字和字符串值得自动转换任何对字符串的算术操作都会现尝试把字符串转换成数字，使用一般规则转换反过来，当一个数值用在需要字符串的地方时数字会自动转换成字符串，遵循一种合理的格式如果要指定数值如何转换成字符串，请使用字符串库中的 forma 函数（見 5.3）
变量是储存值的地方。Lua中有三种不同的变量：全局变量局部变量和表字段。
一个名称可以表示全局变量或局部变量（或者一个函數的正式参数一种局部变量的特殊形式）：
Lua假设变量是全局变量，除非明确地用local进行声明 （见 2.4.7）局部变量有 词义范围（lexically scoped）：局部变量鈳以被在它们范围内的函数自由访问 （见 2.6）。
在变量第一次赋值之前它的值是 nil。
方括号用于对表进行检索：
第一个表达式 (prefixexp)结果必须是表；第二个表达式 (exp) 识别表中一个特定条目给出表的表达式有一个限制语法；详细见 2.5。
访问全局变量和表字段的实质可以通过元表进行改变对索引变量 [i] 的访问等同于调用 geable_even(,i)。（关于 geable_even 的完整描述见 2.8这个函数并没有在Lua中定义，也无法调用我们在这里仅仅用来解释原理）。
都有┅个它自己的环境的引用这样这个函数中的所有的全局变量都会指向这个环境变量表。当新创建一个函数时它会继承创建它的函数的環境。要改变或者获得Lua函数的环境表可以调用 sefenv or gefenv （见 5.1）。
访问全局变量 x 等同于 _env.x又等同于
_env 是运行的函数的环境。（_env 变量并没有在Lua中定义峩们这里仅仅用来解释原理）
Lua支持一种很通俗的语句集，和Pascal或者C中的很相似他包括赋值，控制结构过程调用，表构造和变量声明
Lua执荇的最小单元称之为一个 段（chunk）。一段语句就是简单的语句的序列以顺序执行。每一个语句后面都可以加上一个分号（可选）：
Lua将语句段作为一个匿名函数 （见 2.5.8） 的本体进行处理这样，语句段可以定义局部变量或者返回值
一段语句可以储存在文件内或者宿主程序的一個字符串中。当语句段被执行时他首先被预编译成虚拟机使用的字节码，然后虚拟机用一个解释器执行被编译的代码
语句段也可以被預编译为二进制代码；详情参看 luac 程序。源代码和编译形态可以互相转换；Lua自动监测文件类型然后作相应操作
一个语句块是一系列语句；從语句构成上来看，语句块等同于语句段：
一个语句块可以明确定界来替换单个语句：
显式语句块可以很好地控制变量的声明范围显示語句块有时也常会在另一个语句块的中间添加 reurn 或 break 语句 （见 2.4.4）。
Lua允许多重赋值因此，赋值的语法定义为：等号左边是一个变量表右边是┅个表达式表。两边的表中的元素都用逗号分隔开来：
我们将在 2.5 讨论表达式
在赋值之前，值的表长度会被 调整 为和变量的表一样如果徝比需要的多，多出的值就会被扔掉如果值的数量不够，就会用足够多的 nil 来填充表直到满足数量要求如果表达式表以一个函数调用结束，那么在赋值之前函数返回的所有的值都会添加到值的表中（除非把函数调用放在括号里面；见 2.5）。
赋值语句首先计算出所有的表达式然后才会执行赋值，所以代码：
设置 a[3] 为 20但不影响 a[4]。因为在 a[i] 中的 i 在赋值为4之前是等于3同样的，下面这行：
可以交换 x 和 y 的值
对全局變量和表字段的赋值可以看作是通过元表进行的。对一个索引变量的赋值 [i] = val 等同于 seable_even(,i,val) （seable_even详细介绍参看 2.8 ，Lua中并未定义该函数他也无法直接调鼡。我们这里只是用它来进行解释）
对全局变量的赋值 x = val 等同于赋值语句 _env.x = val，像前面也等同于：
_env 是运行函数的环境（_env 变量并未在Lua中定义。峩们这里只是用来进行解释）
控制结构的条件表达式 exp 可以返回任意值。false 和 nil 都表示假所有其他的值都认为是真（特别要说明的：数字0和涳字符串也表示真）。
语句 reurn 用来从函数或者是语句段中返回一个值函数和语句段都可以返回多个值，所以 reurn 语句的语法为：
break 语句可以用来終止while, repea 或者 for 循环的执行直接跳到循环后面的语句。
break 结束最里面的一个循环
由于语法的原因， reurn 和 break 语句只能作为语句块的 最后一个 语句如果确实需要在语句块的中间使用 reurn 或者 break，需要使用一个显示语句块： `do reurn end? 和 `do break end?，这样现在
reurn 和 break 就成为他们（内部）语句块中的最后一个语句了實际上，这两种用法一般只用在调试中
for 语句有两种形式：数值形式和一般形式。
数值形式的 for 循环根据一个控制变量用算术过程重复一语呴块语法如下：
block 语句块根据 name 以第一个 exp 的值开始，直到他以第三个 exp 为步长达到了第二个 exp一个这样的 for 语句：
- 三种控制表达式只会被计算一佽，在循环开始之前他们的结果必须是数值。
-
_limi 和 _sep 是不可见的变量这里只是为了进行解释。
- 如果你在程序块内给
var 赋值结果行为将会不確定。
- 如果没有给出第三个表达式（步长）那么默认为1。
- 循环变量
var 是局部变量；你不可以在 for 循环结束之后继续使用如果你需要使用这個值，请在退出循环之前把它们传给其他变量
for 的语句的一般形式是操作于函数之上的，称之为迭代器（ieraors）每一个迭代过程，它调用迭玳函数来产生新的值直到新的值是 nil 。一般形式 for 循环有如下语法：
一个这样的 for 语句
-
explis 只会计算一次他的结果是一个 迭代 函数，一个 状态囷给第一个 迭代变量的一个初始值。
-
_f 和 _s 是不可见的变量这里只是用来进行解释说明。
- 如果你在语句块中给
var_1 赋值那么行为就会变得不确萣。
- 循环变量
var_i 是局部变量；你不可以在 for 循环结束之后继续使用如果你需要使用这个值，请在退出循环之前把它们传给其他变量
如果要忽略可能的影响，函数调用可以按照语句执行：
I在这里所有的返回值都会被忽略。函数调用将在 2.5.7 详细解释
局部变量可以在语句块中任哬地方声明。声明时也可以添加一个初始赋值：
如果出现初始赋值他的语法和多重赋值语句一样（见 2.4.3）。否则所有的变量都会初始化為 nil。
一个语句段也是一个语句块（见 2.4.1）所以语句段之内的任何显式语句块之外也可以声明局部变量。这种局部变量在语句段结束就会销毀
局部变量的可见规则会在 2.6解释。
Lua中有以下几种基本表达式：
数字和字符串已经在 2.1 中解释；变量在 2.3 中解释；函数定义在 2.5.8；函数调用在 2.5.7；表构造器在 2.5.6
一个用括号括起的表达式只会返回一个值。这样(f(x,y,z)) 将只会返回单一的一个值，即使 f 可以返回多个值（(f(x,y,z)) 的值将是 f 返回的第一個值或者如果 f 没有返回任何值就是 nil ）。
表达式也可以使用各种算术运算符关系运算符和逻辑运算符，下面几节就会讲到
Lua支持常见的几種运算符：二元 + （加）， - （减） * （乘）， / （除） 以及 ^ （指数运算）； 一元 - （负号）。如果操作数是数字或者是可以转换成数字的字苻串（见
2.2.1），那么所有的操作都和算术意义上的运算一致（除了指数）指数运算其实是调用一个全局函数 __pow，否则一个合适的元方法将会被调用（见 2.8）标准数学库定义了函数 __pow，给出了指数运算的定义（见 5.5）
Lua中的关系运算符有
等于 (==) 先比较操作数的类型。如果类型不一样結果便是 false。否则再比较操作数的值。对象（表用户数据，线程和函数）是按照引用进行比较：只有两个对象是同一个对象的时候，財认为是相等每次你创建一个新的对象（表，用户数据或者是函数）。这个新的对象将不同于前面存在的任何对象
你可以用"eq"元方法妀变Lua比较表的方式（见 2.8）。
而操作符 ~= 是等于 (==) 的相反的操作
操作符的执行顺序如下。如果两个参数都是数字那么它们就直接进行比较。洳果两个参数都是字符串，那么它们的值会根据当前的区域设置进行比较否则，Lua尝试调用"l"或者 "le" 元方法（见 2.8）
Lua中的逻辑运算符是：
和控制结构一样（见 2.4.4），所有的逻辑操作符认为 false 和 nil 都?羌伲?渌?闹刀际钦妗?
合取运算 and 如果第一个参数是 false 或者 nil 则返回第一个参数；否则 and 返回第②个参数析取运算 or 如果第一个参数不是 nil 或 false 则返回第一个参数，否则 or 返回第二个参数 and 和 or
都使用截取计算，也就是只有有必要的情况下財计算第二个参数。例如：
在Lua中字符串连接操作符是两个点 (`..?)如果两边的操作数都是字符或者数字，他们就都会按照 2.2.1的规则被转换成字苻串否则，将调用 "conca" 元方法（见 2.8）
Lua中的操作符的优先级如下表所示，从低到高优先级：
表达式中你可以使用括号来改变优先顺序。串聯接符 (`..?) 和指数符 (`^?) 都是右结合的其他二元操作都是左结合的。
表构造器是创建表的表达式当计算构造器的时候，就会创建一个新的表构造器可以用来创建空的表，或者创建表并初始化一些字段一般的语法如下：
exp 其中 i 是连续的整数，从1开始其它格式的字段不会影響它的计数。例如：
如果列表中最后一个字段的形式是 exp 同时表达式又是一个函数调用那么调用返回的所有值会依次进入列表（见 2.5.7）。如果要避免这种情况在函数调用两边加上括号（见 2.5）。
字段列表可以有一个结尾的分隔符这个对由机器生成的列表十分方便。
Lua中的一个函数调用有如下语法：
在函数调用中首先会计算 prefixexp 和 args 。如果 prefixexp 的值是 funcion 类型那么那个函数就会被调用，同时使用给出的参数否则，他的 "call" 元方法就会被调用第一个参数是 prefixexp 的值，接下来是原来的调用参数（见 2.8）
参数可以有以下几种语法：
所有的参数表达式都会在实际调用之湔进行计算。f{...} 的调用形式在语法上较 f({...}) 要好是因为，参数列表示一个单独的新表 f'...' （或者 f"..." 或者 f[[...]]） 较 f('...')
要好，是因为参数列表是一个单独的字苻串
因为函数可以返回任意个结果（见 2.4.4），结果的数量必须在使用它们前进行调整如果函数按照语句进行调用（见 2.4.6），那么它的返回列表就会被调整为零个元素这样就舍弃了所有的返回值。如果调用函数时他是一个表达式列表的最后一个元素，那么不会做调整（除非调用时加了括号）
如果你用括号括起调用的函数，那么它就会被调整为返回一个值
作为Lua语法自由格式的一个例外，你不能在函数调鼡的 `(? 前面加入一个换行这个限制可以避免语言中的一些二义性。如果你写：
Lua会读作 a = f(g).x(a)这样，如果你想执行为两条语句你必须在中间加分号。如果你实际上想调用 f你就必须删除 (g) 前面的换行。
calls；在一个尾部调用中被调用的函数将会重新使用调用程序的栈。因此程序執行对嵌套尾部调用的次数没有任何限制。然而尾部调用会清楚调用函数的调试信息。注意尾部调用只有在特殊的语法中才能出现也僦是 reurn 只有一个函数调用作为参数，这种语法保证了调用函数确切返回被调用函数的返回值所以，下面的例子都不是尾部调用：
下面较好嘚语法简化了函数定义：
一个函数定义是一个可执行的表达式他的类型为 函数（funcion） 。当Lua预编译语句段的时候他的函数体也会被预编译。这样当Lua执行函数定义的时候，函数被 实例化 （封装 closed）这个函数实例（或闭包
closure）是表达式的最终结果。同一个函数的不同的实例可以引用不同的外部局部变量也可以有不同的环境表
形式参数（代表参数的变量，简称形参）就像用实际参数值（简称实参）初始化的局部變量一样
当调用一个函数时，实参表会调整为和形参一样的长度除非函数是 variadic 或者 变长参数函数（vararg funcion）。变长参数函数在其参数列表最后囿三个点 (`...?) 变长参数函数不会对参数列表进行调整；而是，它把所有的额外实参放到一个隐含的形参 arg中
请思考以下函数定义的例子：
嘫后，我们有以下实参到形参的对应关系：
结果使用 reurn 语句返回（见 2.4.4）如果控制到达了函数尾部而没有遇到 reurn 语句，那么函数没有返回值
冒号（:） 语法是用来定义 mehods 的，也就是函数有一个隐含的额外参数 self. 。这样语句：
相对以下是较好的形式：
Lua是一个有词法范围的语言。变量的范围从声明语句后的第一个语句开始到包含声明的最内部的语句块为止例如：
注意：在类似 local x = x，正在声明的新的 x 尚未进入范围所以苐二个 x 指代的是外面的变量。
由于词法范围的规则在局部变量的范围内定义的函数可以任意访问这些变量。例如：
内部函数使用的局部變量在函数内部称之为 上值（upvalue）或者 外局部变量（exernal local variable）。
注意每个 local 语句执行时会定义一个新的局部变量看以下例子：
循环产生了十个闭包（也就是，十个匿名函数的实例）每个闭包使用不同的 y 变量，但他们共享同一个 x 变量
因为Lua是一个扩展语言，所有的Lua动作都是从宿主程序中调用Lua库中函数的C代码开始的（见 3.15）无论错误发生在Lua编译过程时或执行时，控制返回C然后可以做相应的处理（比如打印一个错误）。
Lua代码可以通过调用error函数来产生一个错误（见 5.1）如果你要在Lua中捕获错误，你可以使用 pcall 函数（见 5.1）
Lua中的每一个表和用户数据都可以拥囿一个 元表（meaable）。这个 元表 是一个普通的Lua表定义了在特定操作下原始表和用户数据的行为。你可以通过设置一个对象的元表中的特定字段来更改它某些方面的行为例如，当一个对象是一个加法的操作数时Lua检查它的元表中的 "__add"
字段是不是一个函数。如果是Lua调用它来执行加法。
我们称元表中的键（字段名key）为 事件（evens） ，值为 元方法（meamehods）在上一个例子中， "add" 是事件执行加法的函数是元方法。
你可以通过 se/gemeaable 函数来查询和更改一个对象的元表（见 5.1）
元表可以控制对象在算术操作、比较、串连接、索引取值中如何运行。元表也可以定义一个函數当收集内存垃圾时调用每一个操作这里Lua都用一个特定的键关联，称之为事件当Lua对一个表或是一个用户数据执行上面中的一个操作时，它先检查元表控制的操作已经罗列在下面每个操作有一个相应的名称，代表了他的含义他们在元表中的键是由名称前加上两条下划線；如，操作 "add" 的键是
"__add"这些操作的语义
这里给出的Lua代码仅仅是说明性的；真正的行为是硬编码在解释器中的，比下面的的模拟的效率要高佷多描述中用到的函数 (rawge, onumber, 等等) 在 5.1 中会对他们进行描述。特别地要获得一个给定对象的元方法，我们使用这个表达式：
也就是访问元方法时不会调用其它元方法，同时调用没有元表的对象不会出错（它返回一个 nil值）
Lua 会自动进行内存管理。这意味着你不需要担心新对象的内存分配问题也不需要释放不用的对象。Lua 通过不断地运行 垃圾收集器 收集 dead objecs
（也就是那些Lua中无法访问的对象）来自动管理内存Lua中所有的对象都是自动管理的目标：表，用户数据函数，线程和字符串。Lua使鼡两个数字控制垃圾收集循环一个数字表示Lua使用的动态内存的字节数，另一个是阀值当内存字节数到达阀值时，Lua就运行垃圾收集器來释放死对象的空间。一旦字节计数器被调整那么阀值就会被设为字节计数器新值的两倍。
通过C API你可以查询和更改阀值（见 3.7）。将阀徝设为零时会强制立刻进行垃圾收集同时把他设为足够大就可以停止垃圾收集。仅使用Lua代码中的 gcinfo 和 collecgarbage 函数 （见 5.1）可以获得一定程度上对垃圾收集循环的控制
使用 C API，你可以对用户数据设置一个垃圾收集元方法（见 2.8）这些元方法也称为 终结器（finalizers）。终结器允许你用外部的资源管理来调整Lua的垃圾收集（如关闭文件网络或数据库连接，或者释放你自己的内存
用元表中包含 __gc 字段的自由用户数据不会立即被垃圾收集器回收。而是Lua把它们放在一个列表中。收集完毕之后Lua会对这个列表中的用户数据执行和以下函数相等的操作：
在每个垃圾收集过程最后，调用用户数据的终结器的顺序将按照他们在收集过程中添加到列表中的相反顺序进行。也就是第一个被调用的终结器是和在程序中创建的最后一个用户数据相关的那个终结器。
一个 弱表（weak able） 是一个包含的元素是 弱引用（weak references）的表垃圾收集器会忽略弱引用。换句話说如果指向一个对象的引用只有弱引用，那么这个对象还是要被垃圾收集器回收
弱表可以包含弱的键，弱的值或者两者皆有。一個包含弱键的表允许它的键被回收但值不可以。一个同时包含弱键和弱值的表允许键和值的回收无论哪种情况，只要键或者值中的一個被回收了那么这一对键值将会从表中删除。这个表的弱属性是由它的元表的 __mode 字段控制的如果 __mode
字段是一个包含字符 `k?的字符串，那么表中的键是弱键。如果 __mode 字段是一个包含字符 `v? 的字符串，那么表中的值是弱值
在你将表用作元表之后，你不应该更改 __mode 字段的值否则，這个元表控制的表的弱表行为将会不确定
Lua支持同步程序，也称为 半同步程序（semi-corouines） 或 协同多线程（collaboraive mulihreading）Lua中的一个同步程序代表了一个独立嘚执行线程。然而不像在多线程系统中的线程那样，一个同步程序只有在调用了一个yield（产生结果）函数才能挂起它的执行
你可以调用 corouine.creae 來创建一个同步程序。它唯一的一个参数是一个函数代表同步程序的主函数。creae 函数仅仅建立一个新的同步程序然后返回一个它的句柄 （┅个线程 hread 类型的对象）；它不会启动该同步程序
当你第一次调用 corouine.resume，将 corouine.creae 返回的线程对象作为第一个参数传递给它然后同步程序就启动了，从它的主函数的第一行开始传给 corouine.resume
的额外的参数会作为同步程序主函数的参数传递过去。在同步程序开始执行之后它一直运行到它结束或产生结果。
一个同步程序通过两种方式结束它的运行：正常情况下当它的主函数返回（显式地或隐式的，在最后一个指令之后）时結束；异常地如果有未保护的错误。第一各情况下corouine.resume 返回 rue，加上同步程序主函数返回的其它值在有错误的情况下，corouine.resume 返回 false
一个同步程序通过调用 corouine.yield 来产生结果当一个同步程序产生结果，相应的 corouine.resume 就立刻返回即使操作发生在嵌套函数调用中（也就是，不在主函数中而在被主函数直接或间接调用的函数中）。在这种情况下 corouine.resume 也返回
corouine.wrap 函数创建一个和 corouine.creae 一样的同步程序，但它不返回同步程序本身而是返回一个继續同步程序的函数（当调用的时候）。传递给这个函数的参数作为继续resume的额外参数函数将返回resume返回的所有值，出除了第一个（布尔值的錯误代码）不像
corouine.resume，这个函数不捕获错误；出现任何错误都传回给调用者
当你运行它的时候，它会产生以下输出结果：
这一节描述Lua中的C API这是对于宿主程序可用的C函数集合，用以和Lua通讯所有的API函数及其相关类型和常量都声明在头文件lua.h中。
即便每次我都使用“函数”这个詞任何设施在API里面都可能被一个宏所替代。所有这些宏（macro）都只使用一次它的参数（除了第一个参数、这个每次总是一个Lua状态）所以鈈会产生隐藏的副作用。
Lua库是可重入的（reenran）的：它没有全局变量整个Lua解释器的状态（全局变量、栈、等等）储存在一个动态分配的 lua_Sae 结构類型中。一个指向这个状态的指针必须作为库中每一个函数的第一个参数除了 lua_open 这个函数。该函数从最开始创建一个Lua状态
在调用任何API函數之前，你必须通过调用 lua_open 创建一个状态：
这个函数销毁所有被给予Lua状态的对象（调用相应的垃圾收集元方法）并且释放那个状态使用的所囿动态内存在个别的平台上，你或许不需要调用这个函数因为当宿主程序结束的时候会自然的释放所有的资源。另一方面长时间运荇的程序，像一些守护进程或者Web服务器可能需要立即释放那些不需要的状态资源，以避免占用太多内存
只要Lua调用C语言函数，这个所调鼡的函数将得到一个新的栈这个栈将独立于先前的栈以及那些仍然活跃的C函数的栈。这个栈最初包含了C函数的所有参数并且这也会存放C函数的返回值（见 3.16）。
为了方便起见大多数查询操作的API不需要遵守一个严格的栈定义（注：即不需要遵循FILO）。他们可以使用 索引（index） 引用任何栈中元素：一个正数索引代表了栈中的绝对位置（从1开始）；一个负数索引代表了从栈顶的偏移量更特别的是，如果栈有 n 个元素那么索引 1
代表第一个元素（这就是说，这个元素首先入栈）并且索引 n 代表了最后一个元素；索引 -1 也代表了最后一个元素（也就是栈顶）并且索引 -n 代表了第一个元素我们说一个索引存在于 1 和栈顶之间是有效的，换句话说如果 1 &l;= abs(index) &l;= op。
在任何时间里你可以调用 lua_geop 得到栈顶元素嘚索引：
因为索引从 1 开始，lua_geop 的结果等于栈中的元素数量（如果是0就意味着栈为空）
当你与Lua API交互的时候，你有责任控制堆栈以避免溢出。这个函数
使栈的大小增长为 op + exra 个元素；如果无法将栈增加到那个大小将返回false这个函数从不对栈进行收缩；如果栈已经比新的大小更大，咜将不产生任何作用那个
只要Lua调用C 函数，它必须至少保证 LUA_MINSACK 这个栈中的位置是可用的LUA_MINSACK 定义在 lua.h 中，它的值是 20所以你不需要总担心栈空间除非你的代码通过循环将元素压入栈。
大多数插叙函数接受指向有效栈空间的索引那就是说，索引达到栈空间的最大值是你需要使用 lua_checksack這样的索引称为可接受索引（accepable indices）。更正规的说法我们给出一个严格的定义如下：
注意，0永远不是一个可接受索引
除非另外说明，任何函数接受有效索引可以被称为是 伪索引（pseudo-indices）这些索引代表一些Lua值可以被C 代码访问但是却不存在于栈中。假索引通常用于访问全局环境变量注册表，和一个C 函数的上值（见 3.17）
一下的API提供了基本的栈操作：
lua_seop 接受任何可接受的索引，或者0并且将该索引设置为栈顶。如果新嘚栈顶比旧的更大那么新元素被填上 nil 值。如果索引为 0那么所有栈元素会被清除。在 lua.h 里面定义了一个有用的宏
用以从栈中弹出 n 个元素
lua_pushvalue 將一个索引指向的元素的拷贝压入栈。 lua_remove 删除指定位置的元素将该元素上方的所有元素下移以填满空缺。lua_inser 将栈顶元素移动到指定位置将該位置以上的元素上移。lua_replace
将栈顶元素移动到指定位置而不移动其他任何其他元素（因此替代了给定位置的元素的值）所有这些函数只接受有效的索引。（你不能使用伪索引调用 lua_remove 或 lua_inser因为他们不代表栈中的位置。）
举个例子如果栈开始于 10 20 30 40 50*（自底向上；`*? 标记了栈顶），那麼：
下面的函数可以用来检测栈内元素的类型：
这些函数只能使用可接受的索引
lua_is* 函数返回 1 当对象与所给类型兼容的时候，其他情况返回 0 lua_isboolean 是一个例外：它只针对布尔值时才会成功（否则将是无用的，因为任何值都是一个布尔值）这些函数对于无效引用返回 0。 lua_isnumber
接受数字和鼡数字表示的字符串；lua_issring 接受字符串和数字（见 2.2.1）；lua_isfuncion 接受Lua函数和C函数； lua_isuserdaa 接受完整的和轻量的用户数据要区分C 函数和Lua 函数，你可以使用
这些API還包含了用于比较栈中的两个值的操作：
lua_equal 和 lua_lesshan 在比较他们的副本的时候是等效的（见 2.5.2） lua_rawequal 用于比较基本类型但不包括元方法。如果有任何形式的无效索引这些函数都返回 0（false）。
为了将一个栈中的值转变为指定的C语言类型你需要使用以下的转换函数：
这些函数由任何可接受索引作为参数进行调用。当遇到一个无效索引函数表现为就好像接受了一个错误类型的值。
lua_oboolean 将索引指向的Lua值转换为C语言类型的布尔值（0 戓 1）就像所有Lua中的测试一样，任何不等于 false 或者 nil 的Lua值通过 lua_oboolean 都将返回 1；否则将返回 0当然，如果是一个无效索引也将返回 0。（如果你只想接受真实的布尔值使用
lua_osring 将索引指向的Lua值转换成字符串（cons char*）。Lua值必须是一个字符串或者数字；否则函数返回 NULL。如果值是一个数字lua_osring 会将棧中的真实值变成一个字符串类型。（当 lua_osring
应用于键时这个改变将引起 lua_nex 的混乱）lua_osring 在Lua 状态内部返回一个字符串的指针。这个字符串总是以 0（'\0'）结尾就像C 语言里的一样，但是也可能包含其他 0 在其中如果你不知道一个字符串中是否存在 0 ，你可以使用 lua_srlen
得到它的实际长度因为Lua具囿垃圾收集机制，所以不能保证 lua_osring 返回的指针仍然有效当相应的值从栈中删除之后。如果你在当前函数返回之后还需要这个字符串你需偠复制它并且将它存入注册表（见 3.18）。
lua_opoiner 将栈中?闹底?晃?ㄓ玫腃 语言指针（void *）这个值可能是一个用户数据、表、线程、或者函数；否则，lua_opoiner 返回 NULLLua保证同种类型的不同对象将返回不同指针。没有直接的方法将指针转换回原来的值这个函数通常用于调试。
以下的API函数将C 语言徝压入栈：
这些函数接受一个C 语言值将其转换成相应的Lua 值，并且将结果压入栈需要特别注意的是，lua_pushlsring 和 lua_pushsring 将对所给的字符串做一个内部拷貝lua_pushsring 只能压入合适的C 语言字符串（也就是说，字符串要以 '\0'
结尾并且不能包含内嵌的 0）；否则，你需要使用更通用的 lua_pushlsring 函数它可以接受一個指定的大小。
你可以压入“格式化的”字符串：
这些函数将格式化的字符串压入栈并且返回这个字符串的指针它们和 sprinf、vsprinf 类似，但是有┅些重要的不同之处：
- 你不需要为结果分配空间：结果是Lua字符串并且Lua会关心内存分配问题（和内存释放问题通过垃圾收集机制）。
- 转换受到限制这里没有标志、宽度或精度。转换操作的修饰符可以是简单的`
%%?（在字符串中插入一个`%?），`%s?（插入一个没有大小限制的以 0 結尾的字符串）`%f?（插入一个 lua_Number），`%d?（插入一个
in）`%c?（插入一个 in 作为一个字符）。
连接栈顶的 n 个值将它们弹出，并且将结果留在栈頂如果 n 为 1，结果是单个字符串（也就是说函数什么也不做）；如果 n 是 0，结果是空字符串连接的完成依据Lua的语义（见 2.5.4）。
Lua使用两个数芓控制垃圾收集循环一个数字表示Lua使用的动态内存的字节数，另一个是阀值（见 2.9）。一个数字表示Lua使用的动态内存的字节数另一个昰阀值。当内存字节数到达阀值时Lua就运行垃圾收集器，来释放死对象的空间一旦字节计数器被调整，那么阀值就会被设为字节计数器噺值的两倍
你可以通过以下的函数得到这两个量的当前值：
它们的返回值的单位都是千字节（K byes）。你可以通过下面的函数改变阀值
然后新的阀值得单位也是千字节。当你调用这个函数Lua设置阀新值并且和字节计数器作比较。如果新的阀值小于字节计数器Lua将立刻运行垃圾收集器。特别是 lua_segchreshold(L,0) 强迫进行垃圾收集在这之后，一个新值根据先前的规则被设置
用户数据代表了Lua中使用的C语言值。Lua支持两种用户数据：完整用户数据（full userdaa） 和 轻量用户数据（ligh userdaa）
一个完整用户数据代表了一块内存。它是一个对象（像一个表）：你必须创建它它有自己的え表，当它被回收的时候你可以检测到一个完整用户数据只能与自己相等（基于原始的相等规则）。
一个轻量用户数据代表一个指针咜是?桓鲋担ㄏ褚桓鍪?郑?耗悴⒚挥写唇ㄋ???裁挥性?怼ⅲ??荒鼙换厥眨ㄒ蛭??游幢淮唇ǎ?Ｇ崃坑没??菹嗟鹊奶跫?侵刚胫赶虻牡刂废嗤??
在Lua 代码里，没办法测试用户数据类型是完整的还是轻量的；两者都是 用户数据类型在C 代码里，如果是完整用户数据lua_ype 返囙 LUA_USERDAA，反之返回 LUA_LIGHUSERDAA。
你可以通过下面的函数创建完整用户数据：
这个函数根据指定大小分配一个内存块将用户数据的地址压入栈并且返回這个地址。
lua_ouserdaa （见 3.5）用来取回用户数据的值当你用在完整用户数据的时候，它返回这个块的地址当你用在轻量用户数据的时候，它返回咜的指针当你用在非用数据的时候，返回 NULL
当Lua回收一个完整用户数据，它调用该用户数据的 gc 元方法然后释放该用户数据相应的内存。
丅面的函数允许你操作对象的元表：
lua_gemeaable 将所给对象的元表压入栈如果索引无效，或这个对象不含有元表该函数返回 0 并且不对栈进行任何操作。
lua_semeaable 从栈中弹出一张表并且为所给对象设置一个新的元表当无法给所给对象设置元表的时候该函数返回 0（也就是说，这个对象既不是┅个用户数据也不是一张表）；尽管那样它仍从栈中弹出这张表。
如果没有错误lua_load 将编译过的语句段作为Lua 函数压入栈顶。否则它将压叺一个错误信息。
lua_load 自动检测语句段的类型是文本还是二进制数据并且根据类型将其载入（见程序 luac）。
lua_load 使用一个用户提供的 reader 函数读取语句段的内容当需要调用其它段时，lua_load 调用 reader传递其 daa 参数。必须返回指向语句段所在的新内存块的指针并将段大小设置为 0。为了标志块尾reader 必须返回
NULL。reader 函数可以返回任何大于零的值
在当前的实现中，reader 函数不能调用任何Lua 函数；为了保证这一点它总是会得到为 NULL 的Lua状态。
语句段洺（chunkname） 用于错误信息和调试信息（见 4）
参考辅助库 (lauxlib.c) 了解如何使用 lua_load 以及如何使用现成的函数从文件和字符串中加载语句段。
通过调用以下函数可以创建表：
这个函数创建一张新的空表并将其压入栈。
要从栈中的表里读取值使用：
index 代表表的位置。lua_geable 从栈中弹出一个键并且返回该键对应的值，表仍然留在堆栈中在Lua中，这个函数可能触发一个针对 index 事件的元方法（见 2.8）想要在不调用任何元方法的情况下得到表主键所对应的真实值，使用这个原始（raw）版本：
要将一个值储存到栈中的一张表中你需要将键压入栈，再将值压入栈调用：
index 代表表嘚位置。lua_seable 从栈中弹出主键和值表仍然留在栈中。在Lua中这个操作可能触发针对 seable 或者 newindex 事件的元方法。想要不受这些元方法的影响并且为任意表设置值使用这个原始（raw）版本：
你可以通过这个函数遍历一张表：
index 指向需要被遍历的表。这个函数从堆栈中弹出一个键从表中取┅对键-值压入栈（所给键的下一对）。如果没有更多的元素lua_nex 返回 0（对栈不进行操作）。使用一个 nil 键标示遍历的开始
一个典型的遍历操莋看起来像这样：
当遍历一张表的时候，不要在键上直接调用 lua_osring除非你知道这个键确实是一个字符串。再次调用 lua_osring 改变了所给索引指向的值；这使 lua_nex 的调用发生混乱
所有的全局变量保存在普通的Lua 表中，叫做环境变量初始的环境变量被称作全局环境变量。这张表总是在 LUA_GLOBALSINDEX 这个伪索引处
要访问或改变全局变量的值，你可以对环境变量表使用常规的表操作举个例子，存取一个全局变量的值：
你可以改变一个Lua 线程嘚全局环境变量通过 lua_replace 函数
以下的函数提供获取、设置Lua函数的环境变量的功能：
lua_gefenv 将堆栈中 index 索引指向的函数的环境变量表压入栈。如果函数昰一个C 函数lua_gefenv 将全局环境变量压入栈。lua_sefenv 从栈中弹出一张表并且将其设置为栈中 index
索引处的函数的新环境变量如果给定索引处的对象不是一個Lua 函数，lua_sefenv 返回 0
有一些 API 能够帮助我们将Lua 表作为数组使用，也就是说表只由数字作为索引：
lua_rawgei 将表中的第 n 个元素放入堆栈中的指定位置 index。lua_rawsei 将堆栈中指定位置 index 处的表中的第 n 个元素的值设定为栈顶的值并将原来的值从栈中删除。
定义在Lua 中的函数和C语言函数经过注册就可以被宿主程序调用这些调用必须遵循以下协议：首先，被调用的函数被压入栈；然后函数的参数必须顺序（direc order）输入，也就是说第一个参数需偠被第一个输入。最后函数通过下面的方法调用：
nargs 是你压入栈的参数的数量。所有参数和函数值从堆栈中弹出并且函数结果被压入栈。返回值的数量被调整为 nresuls除非 nresuls 是 LUA_MULRE。在那种情况下所有函数结果都被压入栈。Lua
会检测返回值是否适合栈空间函数返回值按顺序被压入棧（第一个返回值首先入栈），所以调用结束后最后一个返回值在栈顶
下面的例子展示宿主程序如何可以和这个Lua 代码等效：
这里是C 语言裏的做法：
注意上面的代码是“平衡的”：在它结束时，堆栈返回原来的配置这个被认为是良好的编程实践。
（为了展示细节我们只鼡Lua 提供的原始 API 完成这个例子。通常程序员定义并使用几个宏和辅助库函数在Lua 中提供高级存取功能请参考例子中标准库函数的源代码。）
當你通过 lua_call 调用一个函数所调用函数内部产生的错误将向上传递（通过一个 longjmp）。如果你需要处理错误你应该使用 lua_pcall：
会捕获它，将一个单┅值（错误信息）压入栈并且返回错误代码。像 lua_call lua_pcall 总是从栈中删除函数和它的参数。
如果 errfunc 是 0所返回的错误信息就是原始的错误信息。叧外errfunc 给出一个指向错误处理函数（error handler funcion）的栈索引。（在当前的实现中索引不能为伪索引。）假设运行时错误函数将和错误信息一起被調用，并且他的返回值将是 lua_pcall
错误处理函数被用来为错误信息增加更多的调试信息例如栈的记录。这样的信息在 lua_pcall 调用返回后将不能被收集因此栈已经被解开了。
如果 lua_pcall 函数调用成功返回 0否则返回以下的一个错误代码（定义在 lua.h）：
-
LUA_ERRMEM --- 内存分配错误。这样的错误下Lua 不调用错误處理函数
Lua可以通过C 语言写的函数进行扩展，这些函数必须是 lua_CFuncion 类型的作为以下定义：
一个C 函数接收一个Lua 状态并且返回一个整数，数值需要返回给Lua
为了正确的和Lua 通讯，C 函数必须遵循以下协议它定义了参数和返回值传递的方法：一个C 函数在它的堆栈中从Lua获取顺序（第一个参數首先入栈）参数。所以当函数开始时，第一个参数在索引位置 1为了将返回值传递给Lua，一个C 函数将它们顺序压入栈并且返回它们的數量。任何在堆栈中位于返回值以下的值都将被Lua 适当的解除就像Lua 函数一样，一个C 函数被Lua
调用也可以返回很多结果
作为一个例子，下面嘚函数接收一个任意数量的数字参数并且返回它们的平均值和总合：
下面是一些便利的宏用来在Lua中注册一个C 函数：
它接收Lua 中的函数名和一個指向函数的指针这样，上面的C 函数foo可以在Lua中被注册为 average 并被调用
当一个C 函数被创建后，它可以与一些值关联这样创建了一个 C 闭包（C closure）；这些值可以被随时被函数访问。为了使值和C 函数关联首先这些值要被压入栈（有多个值时，第一个值先入）然后这个函数
然后，無论何时C 函数被调用那些值被定为于指定的伪索引处。那些伪索引有一个宏 lua_upvalueindex 产生第一个和函数关联的值在 lua_upvalueindex(1) 处，其他的以此类推当 n
比當前函数的上值大时，lua_upvalueindex(n) 会产生一个可接受的索引（但是无效）
C语言函数和关闭的例子，请参考Lua官方发行版中的标准库（src/lib/*.c）
Lua提供了一个紸册表，一张可以被所有C 代码用来储存任何需要储存的Lua值的预定义表特别是如果C 代码需要维护C 函数以外存活的Lua值。这张表总是位于 LUA_REGISRYINDEX 这个為索引处任何C 语言库可以将数据储存在这张表中，只要它选择的键和其他库不同典型的做法是你应该使用字符串作为主键包含你的库洺或者在你的代码中使用一个包含C
对象地址的轻量用户数据。
在注册表中的整数键被引用机制所使用由辅助库实现，因此不应该被用作其它用途
总的来说，Lua使用C longjmp 机制来处理错误当Lua面对任何错误（例如内存分配错误，类型错误句法错误）它 升起（raises） 一个错误，也就是說它做了一个长跳跃。一个受保护的环境使用 sejmp 设置一个恢复点；任何错误跳至最近最活跃的恢复点
如果错误发生在任何受保护的环境，Lua调用 panic 函数 并且随后调用exi(EXI_FAILURE)你可以将panic 函数变为以下内容。
你的新panic 函数可以避免程序因为没有返回（例如通过一个长跳跃）而退出否则，楿应的Lua 状态将不一致；唯一安全的操作就是关闭它
几乎所有的API 函数都可能引起错误，例如导致一个内存分配错误：lua_open, lua_close, lua_load 和 lua_pcall 这些的函数运行茬保护模式下（也就是说，它们创建了一个受保护的环境并在其中运行）所以它们从不会引起错误。
有另外一个函数将所给的C 函数运行茬保护模式下：
lua_cpcall 在保护模式下调用 funcfunc 由一个包含 ud 的轻量用户数据开始。在错误问题上lua_cpcall 像 lua_pcall 一样返回相同的错误代码（见 3.15），加上在栈顶的┅个错误对象；否则返回
0，并且不对堆栈进行任何操作任何由 func 返回的值都被丢弃。
C 代码可以通过调用下面的函数产生一个Lua错误：
错误信息（实际上可以是任何类型的对象）必须在栈顶这个函数进行一个长跳跃，因此从来不会返回
Lua 提供了操作线程的部分支?帧Ｈ绻?阌卸嘞叱滩僮鞯腃 语言库，那么Lua能够与其协作并且在Lua中实现相同的机制同样，Lua在线程之上实现自己的协同程序系统以下函数用来在Lua中创建一个线程：
这个函数将线程压入栈并且返回代表新线程的 lua_Sae 指针。这个返回的新状态与所有全局对象（例如表）共享初始状态但是有一個独立的运行时堆栈。
每个线程都有自己独立的全局环境表当你创建一个线程，这张表就和所给状态一样但是你可以独自更改它们。
沒有明确的函数可以关闭或者销毁一个线程线程和其他Lua对象一样受垃圾收集程序的支配：
要像协同程序一样操作线程，Lua提供了以下函数：
你需要创建一个线程以便启动协同程序；然后你将函数体和事件参数压入堆栈；然后调用 lua_resumenarg 的值代表参数的数量。当同步程序暂停或者結束执行函数将返回。当它返回后栈中包含的所有值传递给
lua_yield，或者有主体函数返回如果同步程序运行无误，lua_resume 返回 0否则返回一个错誤代码（见 3.15）。对于错误堆栈只包含错误信息。要重起同步程序将作为结果传递给 yield 的值压入堆栈，并且调用 lua_resume
lua_yield 函数只能像C 函数的返回表达式一样被调用，就像下面所展示的：
如果C 函数像这样调用 lua_yield正在运行的同步程序暂停它的执行，并且调用 lua_resume 开始让这个协同程序返回nresuls 這个参数代表了在堆栈中作为结果传递给 lua_resume 的值的数量。
要在不同线程中交换值你可以使用 lua_xmove：
它从堆栈 from 中弹出 n 个值，并将其压入堆栈 o
Lua 没囿内置的调试设施。它使用一种特殊的接口这种接口依赖函数和 钩子（hooks）。该接口允许构造不同种类的调试器分析器以及其他工具用鉯从解释器得到所需的信息。
得到解释程序运行时堆栈信息的主要函数是：
这个函数用一个指定等级的函数的 acivaion record 的标示符填充一个 lua_Debug 结构等級 0 是当前运行函数，然而等级 n+1 是在等级 n 上调用的函数当没有错误发生时，lua_gesack 返回 1；当在比栈更深的等级上调用的时候它返回 0；
lua_Debug 结构被用來携带一个处于活动状态的函数的各种信息：
lua_gesack 只填充结构的私有部分以备之后使用。要填充 lua_Debug 其他有用信息调用
这个函数发生错误是返回 0 （举个例子，一个无效的 wha 选项）wha 字符串中的每个字符选择填充一些 ar 结构的字段，把上面在 lua_Debug 定义中用圆括号括起来的字母作为指示： `S? 填充在 source,
想要从一个不处于活动状态的函数那得到信息（就是不在栈上的函数）你需要将其压入栈并且用 &g;? 作为 wha 字符串的开始。举个例子偠知道函数 f 定义在第几行，你需要这样写
-
source 如果函数在一个字符串中定义那么 source 就是那个字符串。如果函数定义在一个文件中source 开始于一个 `@? 后面跟随文件名。
-
wha 如果这是一个Lua函数显示 "Lua" 字符串， "C" 为C 函数"main" 如果这是一个语句段的main部分，"ail" 如果这是一个做了尾部调用的函数在后面嘚情况里，Lua 没有其他关于这个函部的信息
-
currenline 代表当前函数执行到的行数。如果没有行信息可用currenline 被设置为 -1。
-
name 一个所给函数合理的函数名洇为函数在Lua中属于第一类值，它们没有固定的名字：一些函数可能是多个全局变量的值其他的可能只储存在一个表字段里。lua_geinfo 函数检测函數如何被调用或者是否为一个全局变量的值以寻找一个合适的名字如果找不到合适的名字，name 被设置为
-
"" （空字符串）（当没有其他可选項的时候Lua使用空字符串代替）
-
nups 函数上值的数量。
为了更多的操作局部变量和上值调试接口使用索引：第一个参数或者局部变量索引为 1，鉯此类推直到最后一个活动的局部变量。整个函数中的活动的上值没有特定的顺序
下面的函数允许操作一个所给激活记录的局部变量：
参数 ar 必须是一个被前一个 lua_gesack 调用填充的有效的激活记录或者作为一个钩子函数的参数（见 4.3）。lua_gelocal 获得一个局部变量的索引 n将变量的值压入棧，并且返回变量名lua_selocal
从栈顶分配一个值给变量并且返回变量名。当索引超过活动的局部变量的数量时两个函数都返回 NULL。
以下的函部可鉯操作所给函数的上值（不像局部变量函数的上值即使在函数不处于活动状态的时候都可以被访问）：
这些函数可以作为Lua 函数使用也可鉯作为C 函数使用。（作为Lua 函数上值是函数外部使用的局部变量，因此它被包含在函数闭包中）funcindex 指向栈中的一个函数。lua_geupvalue 得到一个上值的索引
n将上值的值压入栈，并返回其变量名lua_seupvalue 从栈顶分配一个值给上值并返回变量名。当索引大于上值数量时两个函数都返回 NULL。对于C 函數来说这些函数使用空字符串作为所有上值的变量名。
作为一个例子下面的函数列举了所给等级的栈中的函数的所有局部变量名和上徝变量名：
尽管Lua被设计为一种内嵌于C 语言宿主程序中的扩展语言，它还是经常被用作一个独立程序语言一个Lua的解释程序将Lua作为一个独立嘚语言，我们称之为简化的 lua它提供了标准的发行版本。独立的解释器包含了所有标准库加上反射性的调试接口它的使用方式如下：
-
- 将 標准输入（sdin） 当作文件执行；
-
-i 在运行脚本后进入交互模式；
在停止处理选项后，lua 运行所给的脚本传递所给参数 args。当无参数调用时lua 就像 sdin 昰程序的终结时 lua -v -i 所表现的一样，而且还与 lua- 一样
在交互模式中，如果你写入了一个不完整的语句解释器将等待你的完成。
在Unix系统中Lua脚夲可以用 chmod +x 将其变成可执行程序，并且通过 #! 形式例如
（当然，Lua解释器的位置可能有所不同如果 lua 在你的 PAH 中，那么
就是一个更通用的解决方案）
Lua 5.0 是一个主版本，所有与 Lua 4.0 有一些地方不兼容
-
lua_open 不再需要堆栈大小作为参数（堆栈是动态的）。
