From 88c62cebf18e714a43781cb43651ffb58351059d Mon Sep 17 00:00:00 2001 From: Li Jin Date: Mon, 28 Aug 2023 15:59:36 +0800 Subject: update doc. --- doc/docs/zh/README.md | 8 + doc/docs/zh/doc/README.md | 3473 +++++++++++++++++++++++++++++++++++++++++++++ doc/docs/zh/try/README.md | 6 + 3 files changed, 3487 insertions(+) create mode 100755 doc/docs/zh/README.md create mode 100755 doc/docs/zh/doc/README.md create mode 100755 doc/docs/zh/try/README.md (limited to 'doc/docs/zh') diff --git a/doc/docs/zh/README.md b/doc/docs/zh/README.md new file mode 100755 index 0000000..4f2679e --- /dev/null +++ b/doc/docs/zh/README.md @@ -0,0 +1,8 @@ +--- +home: true +heroImage: /image/yuescript.svg +actionText: 快速上手 → +actionLink: /zh/doc/ +footer: MIT Licensed | Copyright © 2023 Li Jin +--- + diff --git a/doc/docs/zh/doc/README.md b/doc/docs/zh/doc/README.md new file mode 100755 index 0000000..cc7ff00 --- /dev/null +++ b/doc/docs/zh/doc/README.md @@ -0,0 +1,3473 @@ +--- +sidebar: auto +title: 参考手册 +--- + +# 月之脚本 + +logo + +## 介绍 + +月之脚本是一种动态语言，可以编译为Lua。它是[Moonscript](https://github.com/leafo/moonscript)的方言。用月之脚本编写的代码既有表现力又非常简洁。它适合编写一些更易于维护的代码，并在嵌入 Lua 的环境中运行，如游戏或网站服务器。 + +Yue（月）是中文中“月亮”的名称。 + +### 月之脚本概览 +```moonscript +-- 导入语法 +import "yue" as :p, :to_lua + +-- 隐式对象 +inventory = + equipment: + * "sword" + * "shield" + items: + * name: "potion" + count: 10 + * name: "bread" + count: 3 + +-- 管道操作符 +{1, 2, 3} + |> map (x)-> x * 2 + |> filter (x)-> x > 4 + |> reduce 0, (a, b)-> a + b + |> print + +-- 元表操作 +apple = + size: 15 + : {color: 0x00ffff} +p apple.color, apple. if apple.<>? + +-- 类似js的导出语法 +export 🌛 = "月之脚本" +``` + +
+-- 导入语法
+import "yue" as :p, :to_lua
+
+-- 隐式对象
+inventory =
+  equipment:
+    * "sword"
+    * "shield"
+  items:
+    * name: "potion"
+      count: 10
+    * name: "bread"
+      count: 3
+
+-- 管道操作符
+{1, 2, 3}
+  |> map (x)-> x * 2
+  |> filter (x)-> x > 4
+  |> reduce 0, (a, b)-> a + b
+  |> print
+
+-- 元表操作
+apple =
+  size: 15
+  <index>: {color: 0x00ffff}
+p apple.color, apple.<index> if apple.<>?
+
+-- 类似js的导出语法
+export 🌛 = "月之脚本"
+
+ + +## 安装 + +* **Lua 模块** + + 安装 [luarocks](https://luarocks.org)，一个Lua模块的包管理器。然后作为Lua模块和可执行文件安装它： + +``` +> luarocks install yuescript +``` + + 或者你可以自己构建 `yue.so` 文件： + +``` +> make shared LUAI=/usr/local/include/lua LUAL=/usr/local/lib/lua +``` + + 然后从路径 **bin/shared/yue.so** 获取二进制文件。 + +* **二进制工具** + + 克隆项目仓库，然后构建并安装可执行文件： +``` +> make install +``` + + 构建不带宏功能的月之脚本编译工具： +``` +> make install NO_MACRO=true +``` + + 构建不带内置Lua二进制文件的月之脚本编译工具： +``` +> make install NO_LUA=true +``` + +## 使用方法 + +### Lua 模块 + +在Lua中使用月之脚本模块： + +* **用法 1** +在Lua中引入 "你的脚本入口文件.yue"。 +```Lua +require("yue")("你的脚本入口文件") +``` +当你在同一路径下把 "你的脚本入口文件.yue" 编译成了 "你的脚本入口文件.lua" 时，仍然可以使用这个代码加载 .lua 代码文件。在其余的月之脚本文件中，只需正常使用 **require** 或 **import**进行脚本引用即可。错误消息中的代码行号也会被正确处理。 + +* **用法 2** +手动引入月之脚本模块并重写消息。 +```lua +local yue = require("yue") +local success, result = xpcall(function() + yue.require("yuescript_module_name") +end, function(err) + return yue.traceback(err) +end) +``` + +* **用法 3** +在Lua中使用月之脚本编译器功能。 +```lua +local yue = require("yue") +local codes, err, globals = yue.to_lua([[ +f = -> + print "hello world" +f! +]],{ + implicit_return_root = true, + reserve_line_number = true, + lint_global = true, + space_over_tab = false, + options = { + target = "5.4", + path = "/script" + } +}) +``` + +### 月之脚本编译工具 + +使用月之脚本编译工具： +``` +使用命令: yue [选项|文件|目录] ... + + -h 打印此消息 + -e str 执行文件或原始代码 + -m 生成压缩代码 + -r 重写输出以匹配原始行号 + -t path 指定放置编译文件的位置 + -o file 将输出写入文件 + -s 在生成的代码中使用空格代替制表符 + -p 将输出写入标准输出 + -b 转储编译时间（不写输出） + -g 转储在NAME LINE COLUMN中使用的全局变量 + -l 从源代码写入行号 + -c 从源代码保留语句前的注释 + -w path 观察更改并编译目录下的每个文件 + -v 打印版本 + -- 从标准输入读取，打印到标准输出 + (必须是第一个且唯一的参数) + + --target=version 指定编译器将生成的Lua版本代码 + (版本只能是 5.1, 5.2, 5.3 或 5.4) + --path=path_str 将额外的Lua搜索路径字符串追加到package.path + + 不带选项执行以进入REPL，在单行输入符号 '$' 后 + 开始或是停止多行输入模式 +``` +  使用案例： +  递归编译当前路径下扩展名为 **.yue** 的每个月之脚本文件： **yue .** +  编译并将结果保存到目标路径： **yue -t /target/path/ .** +  编译并保留调试信息： **yue -l .** +  编译并生成压缩代码： **yue -m .** +  直接执行代码： **yue -e 'print 123'** +  执行一个月之脚本文件： **yue -e main.yue** + +## 宏 + +### 常见用法 + +宏函数用于在编译时执行一段代码来生成新的代码，并将生成的代码插入到最终编译结果中。 + +```moonscript +macro PI2 = -> math.pi * 2 +area = $PI2 * 5 + +macro HELLO = -> "'你好 世界'" +print $HELLO + +macro config = (debugging)-> + global debugMode = debugging == "true" + "" + +macro asserts = (cond)-> + debugMode and "assert #{cond}" or "" + +macro assert = (cond)-> + debugMode and "assert #{cond}" or "#{cond}" + +$config true +$asserts item ~= nil + +$config false +value = $assert item + +-- 传递的表达式被视为字符串 +macro and = (...)-> "#{ table.concat {...}, ' and ' }" +if $and f1!, f2!, f3! + print "OK" +``` + +
+macro PI2 = -> math.pi * 2
+area = $PI2 * 5
+
+macro HELLO = -> "'你好 世界'"
+print $HELLO
+
+macro config = (debugging)->
+  global debugMode = debugging == "true"
+  ""
+
+macro asserts = (cond)->
+  debugMode and "assert #{cond}" or ""
+
+macro assert = (cond)->
+  debugMode and "assert #{cond}" or "#{cond}"
+
+$config true
+$asserts item ~= nil
+
+$config false
+value = $assert item
+
+-- 传递的表达式被视为字符串
+macro and = (...)-> "#{ table.concat {...}, ' and ' }"
+if $and f1!, f2!, f3!
+  print "OK"
+
+ + +### 直接插入代码 + +宏函数可以返回一个包含月之脚本代码的字符串，或是一个包含Lua代码字符串的配置表。 +```moonscript +macro yueFunc = (var)-> "local #{var} = ->" +$yueFunc funcA +funcA = -> "访问月之脚本定义的变量" + +-- 让月之脚本知道你在Lua代码中声明的局部变量 +macro luaFunc = (var)-> { + code: "local function #{var}() end" + type: "lua" + locals: {var} +} +$luaFunc funcB +funcB = -> "访问Lua代码里定义的变量" + +macro lua = (code)-> { + :code + type: "lua" +} + +-- raw字符串的开始和结束符号会自动被去除了再传入宏函数 +$lua[==[ +-- 插入原始Lua代码 +if cond then + print("输出") +end +]==] +``` + +
+macro yueFunc = (var)-> "local #{var} = ->"
+$yueFunc funcA
+funcA = -> "访问月之脚本定义的变量"
+
+-- 让月之脚本知道你在Lua代码中声明的局部变量
+macro luaFunc = (var)-> {
+  code: "local function #{var}() end"
+  type: "lua"
+  locals: {var}
+}
+$luaFunc funcB
+funcB = -> "访问Lua代码里定义的变量"
+
+macro lua = (code)-> {
+  :code
+  type: "lua"
+}
+
+-- raw字符串的开始和结束符号会自动被去除了再传入宏函数
+$lua[==[
+-- 插入原始Lua代码
+if cond then
+  print("输出")
+end
+]==]
+
+ + +### 导出宏 + +宏函数可以从一个模块中导出，并在另一个模块中导入。您必须将导出的宏函数放在一个单独的文件中使用，而且只有宏定义、宏导入和宏展开可以放入这个宏导出模块中。 +```moonscript +-- 文件: utils.yue +export macro map = (items, action)-> "[#{action} for _ in *#{items}]" +export macro filter = (items, action)-> "[_ for _ in *#{items} when #{action}]" +export macro foreach = (items, action)-> "for _ in *#{items} + #{action}" + +-- 文件 main.yue +import "utils" as { + $, -- 表示导入所有宏的符号 + $foreach: $each -- 重命名宏 $foreach 为 $each +} +{1, 2, 3} |> $map(_ * 2) |> $filter(_ > 4) |> $each print _ +``` + +
+-- 文件: utils.yue
+export macro map = (items, action)-> "[#{action} for _ in *#{items}]"
+export macro filter = (items, action)-> "[_ for _ in *#{items} when #{action}]"
+export macro foreach = (items, action)-> "for _ in *#{items}
+  #{action}"
+-- 文件 main.yue
+-- 在浏览器中不支持import函数，请在真实环境中尝试
+--[[
+import "utils" as {
+  $, -- 表示导入所有宏的符号
+  $foreach: $each -- 重命名宏 $foreach 为 $each
+}
+{1, 2, 3} |> $map(_ * 2) |> $filter(_ > 4) |> $each print _
+]]
+
+ + +### 内置宏 + +月之脚本中有一些内置可以直接使用的宏，但你可以通过声明相同名称的宏来覆盖它们。 +```moonscript +print $FILE -- 获取当前模块名称的字符串 +print $LINE -- 获取当前代码行数：2 +``` + +
+print $FILE -- 获取当前模块名称的字符串
+print $LINE -- 获取当前代码行数：2
+
+ + +## 操作符 + +Lua的所有二元和一元操作符在月之脚本中都是可用的。此外，**!=** 符号是 **~=** 的别名，而 **\\** 或 **::** 均可用于编写链式函数调用，如写作 `tb\func!` 或 `tb::func!`。此外月之脚本还提供了一些其他特殊的操作符，以编写更具表达力的代码。 + +```moonscript +tb\func! if tb ~= nil +tb::func! if tb != nil +``` + +
+tb\func! if tb ~= nil
+tb::func! if tb != nil
+
+ + +### 表追加 + +**[] =** 操作符用于向Lua表的最后插入值。 + +```moonscript +tab = {} +tab[] = "Value" +``` + +
+tab = {}
+tab[] = "Value"
+
+ + +### 表扩展 + +您可以使用前置 `...` 操作符在Lua表中插入数组表或哈希表。 + +```moonscript +parts = + * "shoulders" + * "knees" +lyrics = + * "head" + * ...parts + * "and" + * "toes" + +copy = {...other} + +a = {1, 2, 3, x: 1} +b = {4, 5, y: 1} +merge = {...a, ...b} +``` + +
+parts =
+	* "shoulders"
+	* "knees"
+lyrics =
+	* "head"
+	* ...parts
+	* "and"
+	* "toes"
+
+copy = {...other}
+
+a = {1, 2, 3, x: 1}
+b = {4, 5, y: 1}
+merge = {...a, ...b}
+
+ + +### 元表 + +**<>** 操作符可提供元表操作的快捷方式。 + +* **元表创建** +使用空括号 **<>** 或被 **<>** 包围的元方法键创建普通的Lua表。 + +```moonscript +mt = {} +add = (right)=> <>: mt, value: @value + right.value +mt.__add = add + +a = <>: mt, value: 1 +-- 使用与临时变量名相同的字段名，将临时变量赋值给元表 +b = :, value: 2 +c = : mt.__add, value: 3 + +d = a + b + c +print d.value + +close _ = : -> print "超出范围" +``` + +
+mt = {}
+add = (right)=> <>: mt, value: @value + right.value
+mt.__add = add
+
+a = <>: mt, value: 1
+-- 使用与临时变量名相同的字段名，将临时变量赋值给元表
+b = :<add>, value: 2
+c = <add>: mt.__add, value: 3
+
+d = a + b + c
+print d.value
+
+close _ = <close>: -> print "超出范围"
+
+ + +* **元表访问** +使用 **<>** 或被 **<>** 包围的元方法名或在 **<>** 中编写某些表达式来访问元表。 + +```moonscript +-- 使用包含字段 "value" 的元表创建 +tb = <"value">: 123 +tb. = tb.<> +print tb.value + +tb.<> = __index: {item: "hello"} +print tb.item +``` + + +
+-- 使用包含字段 "value" 的元表创建
+tb = <"value">: 123
+tb.<index> = tb.<>
+print tb.value
+tb.<> = __index: {item: "hello"}
+print tb.item
+
+ + +* **元表解构** +使用被 **<>** 包围的元方法键解构元表。 + +```moonscript +{item, :new, :, : getter} = tb +print item, new, close, getter +``` + +
+{item, :new, :<close>, <index>: getter} = tb
+print item, new, close, getter
+
+ + +### 存在性 + +**?** 运算符可以在多种上下文中用来检查存在性。 + +```moonscript +func?! +print abc?["你好 世界"]?.xyz + +x = tab?.value +len = utf8?.len or string?.len or (o)-> #o + +if print and x? + print x + +with? io.open "test.txt", "w" + \write "你好" + \close! +``` + +
+func?!
+print abc?["你好 世界"]?.xyz
+
+x = tab?.value
+len = utf8?.len or string?.len or (o)-> #o
+
+if print and x?
+  print x
+
+with? io.open "test.txt", "w"
+  \write "你好"
+  \close!
+
+ + +### 管道 + +与其使用一系列嵌套的函数调用，您还可以考虑使用运算符 **|>** 来传递值。 + +```moonscript +"你好" |> print +1 |> print 2 -- 将管道项作为第一个参数插入 +2 |> print 1, _, 3 -- 带有占位符的管道 + +-- 多行的管道表达式 +readFile "example.txt" + |> extract language, {} + |> parse language + |> emit + |> render + |> print +``` + +
+"你好" |> print
+1 |> print 2 -- 将管道项作为第一个参数插入
+2 |> print 1, _, 3 -- 带有占位符的管道
+-- 多行的管道表达式
+readFile "example.txt"
+  |> extract language, {}
+  |> parse language
+  |> emit
+  |> render
+  |> print
+
+ + +### 空值合并 + +如果其左操作数不是**nil**，则nil合并运算符 **??** 返回其左操作数的值；否则，它将计算右操作数并返回其结果。如果左操作数计算结果为非nil的值，**??** 运算符将不再计算其右操作数。 +```moonscript +local a, b, c, d +a = b ?? c ?? d +func a ?? {} + +a ??= false +``` + +
+local a, b, c, d
+a = b ?? c ?? d
+func a ?? {}
+a ??= false
+
+ + +### 隐式对象 + +您可以在表格块内使用符号 **\*** 开始编写一系列隐式结构。如果您正在创建隐式对象，对象的字段必须具有相同的缩进。 +```moonscript +list = + * 1 + * 2 + * 3 + +func + * 1 + * 2 + * 3 + +tb = + name: "abc" + + values: + * "a" + * "b" + * "c" + + objects: + * name: "a" + value: 1 + func: => @value + 1 + tb: + fieldA: 1 + + * name: "b" + value: 2 + func: => @value + 2 + tb: { } + +``` + +
+list =
+  * 1
+  * 2
+  * 3
+
+func
+  * 1
+  * 2
+  * 3
+
+tb =
+  name: "abc"
+
+  values:
+    * "a"
+    * "b"
+    * "c"
+
+  objects:
+    * name: "a"
+      value: 1
+      func: => @value + 1
+      tb:
+        fieldA: 1
+
+    * name: "b"
+      value: 2
+      func: => @value + 2
+      tb: { }
+
+ + +## 模块 + +### 导入 + +导入语句是一个语法糖，用于需要引入一个模块或者从已导入的模块中提取子项目。从模块导入的变量默认为不可修改的常量。 + +```moonscript +-- 用作表解构 +do + import insert, concat from table + -- 当给 insert, concat 变量赋值时，编译器会报告错误 + import C, Ct, Cmt from require "lpeg" + +-- 快捷地导入一个模块 +do + import 'module' + import 'module_x' + import "d-a-s-h-e-s" + import "module.part" + +-- 导入模块后起一个别名使用，或是进行导入模块表的解构 +do + import "player" as PlayerModule + import "lpeg" as :C, :Ct, :Cmt + import "export" as {one, two, Something:{umm:{ch}}} +``` + +
+-- 用作表解构
+do
+  import insert, concat from table
+  -- 当给 insert, concat 变量赋值时，编译器会报告错误
+  import C, Ct, Cmt from require "lpeg"
+
+-- 快捷地导入一个模块
+do
+  import 'module'
+  import 'module_x'
+  import "d-a-s-h-e-s"
+  import "module.part"
+
+-- 导入模块后起一个别名使用，或是进行导入模块表的解构
+do
+  import "player" as PlayerModule
+  import "lpeg" as :C, :Ct, :Cmt
+  import "export" as {one, two, Something:{umm:{ch}}}
+
+ + +### 导出 + +导出语句提供了一种简洁的方式来定义当前的模块。 + +* **命名导出** +带命名的导出将定义一个局部变量，并在导出的表中添加一个同名的字段。 + +```moonscript +export a, b, c = 1, 2, 3 +export cool = "cat" + +export What = if this + "abc" +else + "def" + +export y = -> + hallo = 3434 + +export class Something + umm: "cool" +``` + +
+export a, b, c = 1, 2, 3
+export cool = "cat"
+
+export What = if this
+  "abc"
+else
+  "def"
+
+export y = ->
+  hallo = 3434
+
+export class Something
+  umm: "cool"
+
+ + +使用解构进行命名导出。 + +```moonscript +export :loadstring, to_lua: tolua = yue +export {itemA: {:fieldA = '默认值'}} = tb +``` + +
+export :loadstring, to_lua: tolua = yue
+export {itemA: {:fieldA = '默认值'}} = tb
+
+ + +从模块导出命名项目时，可以不用创建局部变量。 + +```moonscript +export.itemA = tb +export. = items +export["a-b-c"] = 123 +``` + +
+export.itemA = tb
+export.<index> = items
+export["a-b-c"] = 123
+
+ + +* **未命名导出** +未命名导出会将要导出的目标项目添加到导出表的数组部分。 + +```moonscript +d, e, f = 3, 2, 1 +export d, e, f + +export if this + 123 +else + 456 + +export with tmp + j = 2000 +``` + +
+d, e, f = 3, 2, 1
+export d, e, f
+
+export if this
+  123
+else
+  456
+
+export with tmp
+  j = 2000
+
+ + +* **默认导出** +在导出语句中使用 **default** 关键字，来替换导出的表为一个目标的对象。 + +```moonscript +export default -> + print "你好" + 123 +``` + +
+export default ->
+  print "你好"
+  123
+
+ + +## 赋值 + +月之脚本中定义的变量是动态类型的，并默认为局部变量。但你可以通过**local**和**global**声明来改变声明变量的作用范围。 + +```moonscript +hello = "world" +a, b, c = 1, 2, 3 +hello = 123 -- 访问现有的变量 +``` + +
+hello = "world"
+a, b, c = 1, 2, 3
+hello = 123 -- 访问现有的变量
+
+ + +### 执行更新 + +你可以使用各式二进制运算符执行更新赋值。 +```moonscript +x = 1 +x += 1 +x -= 1 +x *= 10 +x /= 10 +x %= 10 +s ..= "world" -- 如果执行更新的局部变量不存在，将新建一个局部变量 +arg or= "默认值" +``` + +
+x = 1
+x += 1
+x -= 1
+x *= 10
+x /= 10
+x %= 10
+s ..= "world" -- 如果执行更新的局部变量不存在，将新建一个局部变量
+arg or= "默认值"
+
+ + +### 链式赋值 + +你可以进行链式赋值，将多个项目赋予相同的值。 +```moonscript +a = b = c = d = e = 0 +x = y = z = f! +``` + +
+a = b = c = d = e = 0
+x = y = z = f!
+
+ + +### 显式声明局部变量 +```moonscript +do + local a = 1 + local * + print "预先声明后续所有变量为局部变量" + x = -> 1 + y + z + y, z = 2, 3 + global instance = Item\new! + +do + local X = 1 + local ^ + print "只预先声明后续大写的变量为局部变量" + a = 1 + B = 2 +``` + +
+do
+  local a = 1
+  local *
+  print "预先声明后续所有变量为局部变量"
+  x = -> 1 + y + z
+  y, z = 2, 3
+  global instance = Item\new!
+
+do
+  local X = 1
+  local ^
+  print "只预先声明后续大写的变量为局部变量"
+  a = 1
+  B = 2
+
+ + +### 显式声明全局变量 +```moonscript +do + global a = 1 + global * + print "预先声明所有变量为全局变量" + x = -> 1 + y + z + y, z = 2, 3 + +do + global x = 1 + global ^ + print "只预先声明大写的变量为全局变量" + a = 1 + B = 2 + local Temp = "一个局部值" +``` + +
+do
+  global a = 1
+  global *
+  print "预先声明所有变量为全局变量"
+  x = -> 1 + y + z
+  y, z = 2, 3
+
+do
+  global x = 1
+  global ^
+  print "只预先声明大写的变量为全局变量"
+  a = 1
+  B = 2
+  local Temp = "一个局部值"
+
+ + +## 解构赋值 + +解构赋值是一种快速从Lua表中按名称或基于数组中的位置提取值的方法。 + +通常当你看到一个字面量的Lua表，比如{1,2,3}，它位于赋值的右侧，因为它是一个值。解构赋值语句的写法就是交换了字面量Lua表的角色，并将其放在赋值语句的左侧。 + +最好是通过示例来解释。以下是如何从表格中解包前两个值的方法： + +```moonscript +thing = {1, 2} + +{a, b} = thing +print a, b +``` + + +
+thing = {1, 2}
+
+{a, b} = thing
+print a, b
+
+ + +在解构表格字面量中，键代表从右侧读取的键，值代表读取的值将被赋予的名称。 + +```moonscript +obj = { + hello: "world" + day: "tuesday" + length: 20 +} + +{hello: hello, day: the_day} = obj +print hello, the_day + +:day = obj -- 可以不带大括号进行简单的解构 +``` + +
+obj = {
+  hello: "world"
+  day: "tuesday"
+  length: 20
+}
+
+{hello: hello, day: the_day} = obj
+print hello, the_day
+
+:day = obj -- 可以不带大括号进行简单的解构
+
+ + +这也适用于嵌套的数据结构： + +```moonscript +obj2 = { + numbers: {1,2,3,4} + properties: { + color: "green" + height: 13.5 + } +} + +{numbers: {first, second}} = obj2 +print first, second, color +``` + +
+obj2 = {
+  numbers: {1,2,3,4}
+  properties: {
+    color: "green"
+    height: 13.5
+  }
+}
+
+{numbers: {first, second}} = obj2
+print first, second, color
+
+ + +如果解构语句很复杂，也可以任意将其分散在几行中。稍微复杂一些的示例： + +```moonscript +{ + numbers: {first, second} + properties: { + color: color + } +} = obj2 +``` + +
+{
+  numbers: {first, second}
+  properties: {
+    color: color
+  }
+} = obj2
+
+ + +有时候我们会需要从Lua表中提取值并将它们赋给与键同名的局部变量。为了避免编写重复代码，我们可以使用**:**前缀操作符： + +```moonscript +{:concat, :insert} = table +``` + +
+{:concat, :insert} = table
+
+ + +这样的用法与导入语法有些相似。但我们可以通过混合语法重命名我们想要提取的字段： + +```moonscript +{:mix, :max, random: rand} = math +``` + +
+{:mix, :max, random: rand} = math
+
+ + +在进行解构时，您可以指定默认值，如： + +```moonscript +{:name = "nameless", :job = "jobless"} = person +``` + +
+{:name = "nameless", :job = "jobless"} = person
+
+ + +在进行列表解构时，您可以使用`_`作为占位符： + +```moonscript +{_, two, _, four} = items +``` + +
+{_, two, _, four} = items
+
+ + +### 在其它地方的解构 + +解构也可以出现在其它隐式进行赋值的地方。一个例子是用在for循环： + +```moonscript +tuples = { + {"hello", "world"} + {"egg", "head"} +} + +for {left, right} in *tuples + print left, right +``` + +
+tuples = {
+  {"hello", "world"}
+  {"egg", "head"}
+}
+
+for {left, right} in *tuples
+  print left, right
+
+ + +我们知道数组表中的每个元素都是一个两项的元组，所以我们可以直接在for语句的名称子句中使用解构来解包它。 + +## If 赋值 + +`if` 和 `elseif` 代码块可以在条件表达式的位置进行赋值。在代码执行到要计算条件时，会首先进行赋值计算，并使用赋与的值作为分支判断的条件。赋值的变量仅在条件分支的代码块内有效，这意味着如果值不是真值，那么它就不会被用到。 + +```moonscript +if user = database.find_user "moon" + print user.name +``` + +
+if user = database.find_user "moon"
+  print user.name
+
+ + +```moonscript +if hello = os.getenv "hello" + print "你有 hello", hello +elseif world = os.getenv "world" + print "你有 world", world +else + print "什么都没有 :(" +``` + +
+if hello = os.getenv "hello"
+  print "你有 hello", hello
+elseif world = os.getenv "world"
+  print "你有 world", world
+else
+  print "什么都没有 :("
+
+ + +使用多个返回值的 If 赋值。只有第一个值会被检查，其他值都有同样的作用域。 +```moonscript +if success, result = pcall -> "无报错地获取结果" + print result -- 变量 result 是有作用域的 +print "好的" +``` + +
+if success, result = pcall -> "无报错地获取结果"
+  print result -- 变量 result 是有作用域的
+print "好的"
+
+ + +## 可变参数赋值 + +您可以将函数返回的结果赋值给一个可变参数符号 `...`。然后使用Lua的方式访问其内容。 +```moonscript +list = {1, 2, 3, 4, 5} +fn = (ok) -> ok, table.unpack list +ok, ... = fn true +count = select '#', ... +first = select 1, ... +print ok, count, first +``` + +
+list = {1, 2, 3, 4, 5}
+fn = (ok) -> ok, table.unpack list
+ok, ... = fn true
+count = select '#', ...
+first = select 1, ...
+print ok, count, first
+
+ + +## 空白 + +月之脚本是一个对空白敏感的语言。您必须在相同的缩进中使用空格 **' '** 或制表符 **'\t'** 来编写一些代码块，如函数体、值列表和一些控制块。包含不同空白的表达式可能意味着不同的事情。制表符被视为4个空格，但最好不要混合使用空格和制表符。 + +### 多行链式调用 + +你可以使用相同的缩进来编写多行链式函数调用。 +```moonscript +Rx.Observable + .fromRange 1, 8 + \filter (x)-> x % 2 == 0 + \concat Rx.Observable.of 'who do we appreciate' + \map (value)-> value .. '!' + \subscribe print +``` + +
+Rx.Observable
+  .fromRange 1, 8
+  \filter (x)-> x % 2 == 0
+  \concat Rx.Observable.of 'who do we appreciate'
+  \map (value)-> value .. '!'
+  \subscribe print
+
+ + +## 注释 + +```moonscript +-- 我是一个注释 + +str = --[[ +这是一个多行注释。 +没问题。 +]] strA \ -- 注释 1 + .. strB \ -- 注释 2 + .. strC + +func --[[端口]] 3000, --[[ip]] "192.168.1.1" +``` + +
+-- 我是一个注释
+
+str = --[[
+这是一个多行注释。
+没问题。
+]] strA \ -- 注释 1
+  .. strB \ -- 注释 2
+  .. strC
+
+func --[[端口]] 3000, --[[ip]] "192.168.1.1"
+
+ + +## 错误处理 + +用于统一进行Lua错误处理的便捷语法。 + +```moonscript +try + func 1, 2, 3 +catch err + print yue.traceback err + +success, result = try + func 1, 2, 3 +catch err + yue.traceback err + +try func 1, 2, 3 +catch err + print yue.traceback err + +success, result = try func 1, 2, 3 + +try + print "尝试中" + func 1, 2, 3 + +-- 使用if赋值模式 +if success, result = try func 1, 2, 3 +catch err + print yue.traceback err + print result +``` + +
+try
+  func 1, 2, 3
+catch err
+  print yue.traceback err
+
+success, result = try
+  func 1, 2, 3
+catch err
+  yue.traceback err
+
+try func 1, 2, 3
+catch err
+  print yue.traceback err
+
+success, result = try func 1, 2, 3
+
+try
+  print "尝试中"
+  func 1, 2, 3
+
+-- 使用if赋值模式
+if success, result = try func 1, 2, 3
+catch err
+    print yue.traceback err
+  print result
+
+ + +## 属性 + +月之脚本现在提供了Lua 5.4新增的叫做属性的语法支持。在月之脚本编译到的Lua目标版本低于5.4时，你仍然可以同时使用`const`和`close`的属性声明语法，并获得常量检查和作用域回调的功能。 + +```moonscript +const a = 123 +close _ = : -> print "超出范围。" +``` + +
+const a = 123
+close _ = <close>: -> print "超出范围。"
+
+ + +你可以对进行解构得到的变量标记为常量。 + +```moonscript +const {:a, :b, c, d} = tb +-- a = 1 +``` + +
+const {:a, :b, c, d} = tb
+-- a = 1
+
+ + +## 字面量 + +Lua中的所有基本字面量都可以在月之脚本中使用。包括数字、字符串、布尔值和**nil**。 + +但与Lua不同的是，单引号和双引号字符串内部允许有换行： + +```moonscript +some_string = "这是一个字符串 + 并包括一个换行。" + +-- 使用#{}语法可以将表达式插入到字符串字面量中。 +-- 字符串插值只在双引号字符串中可用。 +print "我有#{math.random! * 100}%的把握。" +``` + +
+some_string = "这是一个字符串
+  并包括一个换行。"
+
+-- 使用#{}语法可以将表达式插入到字符串字面量中。
+-- 字符串插值只在双引号字符串中可用。
+print "我有#{math.random! * 100}%的把握。"
+
+ + +### 数字字面量 + +您可以在数字字面量中使用下划线来增加可读性。 + +```moonscript +integer = 1_000_000 +hex = 0xEF_BB_BF +``` + + +
+integer = 1_000_000
+hex = 0xEF_BB_BF
+
+ + +## 函数字面量 + +所有函数都是使用月之脚本的函数表达式创建的。一个简单的函数可以用箭头表示为：**->**。 + +```moonscript +my_function = -> +my_function() -- 调用空函数 +``` + +
+my_function = ->
+my_function() -- 调用空函数
+
+ + +函数体可以是紧跟在箭头后的一个语句，或者是在后面的行上使用同样缩进的一系列语句： + +```moonscript +func_a = -> print "你好，世界" + +func_b = -> + value = 100 + print "这个值是：", value +``` + +
+func_a = -> print "你好，世界"
+
+func_b = ->
+  value = 100
+  print "这个值是：", value
+
+ + +如果一个函数没有参数，可以使用**!**操作符调用它，而不是空括号。使用**!**调用没有参数的函数是推荐的写法。 + +```moonscript +func_a! +func_b() +``` + +
+func_a!
+func_b()
+
+ + +带有参数的函数可以通过在箭头前加上括号中的参数名列表来进行创建： + +```moonscript +sum = (x, y)-> print "数字的和", x + y +``` + +
+sum = (x, y)-> print "数字的和", x + y
+
+ + +函数可以通过在函数名后列出参数来调用。当对函数做嵌套的调用时，后面列出的参数会应用于左侧最近的函数。 + +```moonscript +sum 10, 20 +print sum 10, 20 + +a b c "a", "b", "c" +``` + +
+sum 10, 20
+print sum 10, 20
+
+a b c "a", "b", "c"
+
+ + +为了避免在调用函数时产生歧义，也可以使用括号将参数括起来。比如在以下的例子中是必需的，这样才能确保参数被传入到正确的函数。 + +```moonscript +print "x:", sum(10, 20), "y:", sum(30, 40) +``` + +
+print "x:", sum(10, 20), "y:", sum(30, 40)
+
+ + +注意：函数名与开始括号之间不能有任何空格。 + +函数会将函数体中的最后一个语句强制转换为返回语句，这被称作隐式返回： + +```moonscript +sum = (x, y)-> x + y +print "数字的和是", sum 10, 20 +``` + +
+sum = (x, y) -> x + y
+print "数字的和是", sum 10, 20
+
+ + +如果您需要做显式返回，可以使用return关键字： + +```moonscript +sum = (x, y)-> return x + y +``` + +
+sum = (x, y)-> return x + y
+
+ + +就像在Lua中一样，函数可以返回多个值。最后一个语句必须是由逗号分隔的值列表： + +```moonscript +mystery = (x, y)-> x + y, x - y +a, b = mystery 10, 20 +``` + +
+mystery = (x, y)-> x + y, x - y
+a, b = mystery 10, 20
+
+ + +### 粗箭头 + +因为在Lua中调用方法时，经常习惯将对象作为第一个参数传入，所以月之脚本提供了一种特殊的语法来创建自动包含self参数的函数。 + +```moonscript +func = (num)=> @value + num +``` + +
+func = (num)=> @value + num
+
+ + +### 参数默认值 + +可以为函数的参数提供默认值。如果参数的值为nil，则确定该参数为空。任何具有默认值的nil参数在函数体运行之前都会被替换。 + +```moonscript +my_function = (name = "某物", height = 100)-> + print "你好，我是", name + print "我的高度是", height +``` + +
+my_function = (name = "某物", height = 100)->
+  print "你好，我是", name
+  print "我的高度是", height
+
+ + +函数参数的默认值表达式在函数体中会按参数声明的顺序进行计算。因此，在默认值的表达式中可以访问先前声明的参数。 + +```moonscript +some_args = (x = 100, y = x + 1000)-> + print x + y +``` + +
+some_args = (x = 100, y = x + 1000)->
+  print x + y
+
+ + +### 多行参数 + +当调用接收大量参数的函数时，将参数列表分成多行是很方便的。由于月之脚本语言对空白字符的敏感性，做参数列表的分割时务必要小心。 + +如果要将参数列表写到下一行，那么当前行必须以逗号结束。并且下一行的缩进必须比当前的缩进多。一旦做了参数的缩进，所有其他参数列表的行必须保持相同的缩进级别，以成为参数列表的一部分。 + +```moonscript +my_func 5, 4, 3, + 8, 9, 10 + +cool_func 1, 2, + 3, 4, + 5, 6, + 7, 8 +``` + +
+my_func 5, 4, 3,
+  8, 9, 10
+
+cool_func 1, 2,
+  3, 4,
+  5, 6,
+  7, 8
+
+ + +这种调用方式可以做嵌套。并通过缩进级别来确定参数属于哪一个函数。 + +```moonscript +my_func 5, 6, 7, + 6, another_func 6, 7, 8, + 9, 1, 2, + 5, 4 +``` + +
+my_func 5, 6, 7,
+  6, another_func 6, 7, 8,
+    9, 1, 2,
+  5, 4
+
+ + +因为Lua表也使用逗号作为分隔符，这种缩进语法有助于让值成为参数列表的一部分，而不是Lua表的一部分。 + +```moonscript +x = { + 1, 2, 3, 4, a_func 4, 5, + 5, 6, + 8, 9, 10 +} +``` + +
+x = {
+  1, 2, 3, 4, a_func 4, 5,
+    5, 6,
+  8, 9, 10
+}
+
+ + +有个不常见的写法可以注意一下，如果我们将在后面使用较低的缩进，我们可以为函数参数提供更深的缩进来区分列表的归属。 + +```moonscript +y = { my_func 1, 2, 3, + 4, 5, + 5, 6, 7 +} +``` + +
+y = { my_func 1, 2, 3,
+   4, 5,
+  5, 6, 7
+}
+
+ + +对于其它有代码块跟随的语句，比如条件语句，也可以通过小心安排缩进来做类似的事。比如我们可以通过调整缩进级别来控制一些值归属于哪个语句： + +```moonscript +if func 1, 2, 3, + "你好", + "世界" + print "你好" + print "我在if内部" + +if func 1, 2, 3, + "你好", + "世界" + print "hello" + print "我在if内部" +``` + +
+if func 1, 2, 3,
+  "你好",
+  "世界"
+    print "你好"
+    print "我在if内部"
+
+if func 1, 2, 3,
+    "你好",
+    "世界"
+  print "你好"
+  print "我在if内部"
+
+ + +## 反向回调 + +反向回调用于减少函数回调的嵌套。它们使用指向左侧的箭头，并且默认会被定义为传入后续函数调用的最后一个参数。它的语法大部分与常规箭头函数相同，只是它指向另一方向，并且后续的函数体不需要进行缩进。 + +```moonscript +<- f +print "hello" +``` + +
+<- f
+print "hello"
+
+ + +月之脚本也提供了粗箭头反向回调函数。 + +```moonscript +<= f +print @value +``` + +
+<= f
+print @value
+
+ + +您可以通过一个占位符指定回调函数的传参位置。 + +```moonscript +(x) <- map _, {1, 2, 3} +x * 2 +``` + +
+(x) <- map _, {1, 2, 3}
+x * 2
+
+ + +如果您希望在反向回调处理后继续编写更多其它的代码，您可以使用do语句将不归属反向回调的代码分开。 + +```moonscript +result, msg = do + (data) <- readAsync "文件名.txt" + print data + (info) <- processAsync data + check info +print result, msg +``` + +
+result, msg = do
+  (data) <- readAsync "文件名.txt"
+  print data
+  (info) <- processAsync data
+  check info
+print result, msg
+
+ + +## 表格字面量 + +和Lua一样，表格可以通过花括号进行定义。 + +```moonscript +some_values = { 1, 2, 3, 4 } +``` + +
+some_values = { 1, 2, 3, 4 }
+
+ + +但与Lua不同的是，给表格中的键赋值是用 **:**（而不是 **=**）。 + +```moonscript +some_values = { + name: "Bill", + age: 200, + ["favorite food"]: "rice" +} +``` + +
+some_values = {
+  name: "Bill",
+  age: 200,
+  ["favorite food"]: "rice"
+}
+
+ + +如果只分配一个键值对的表格，可以省略花括号。 + +```moonscript +profile = + height: "4英尺", + shoe_size: 13, + favorite_foods: {"冰淇淋", "甜甜圈"} +``` + +
+profile =
+  height: "4英尺",
+  shoe_size: 13,
+  favorite_foods: {"冰淇淋", "甜甜圈"}
+
+ + +可以使用换行符而不使用逗号（或两者都用）来分隔表格中的值： + +```moonscript +values = { + 1, 2, 3, 4 + 5, 6, 7, 8 + name: "超人" + occupation: "打击犯罪" +} +``` + +
+values = {
+  1, 2, 3, 4
+  5, 6, 7, 8
+  name: "超人"
+  occupation: "打击犯罪"
+}
+
+ + +创建单行表格字面量时，也可以省略花括号： + +```moonscript +my_function dance: "探戈", partner: "无" + +y = type: "狗", legs: 4, tails: 1 +``` + +
+my_function dance: "探戈", partner: "无"
+
+y = type: "狗", legs: 4, tails: 1
+
+ + +表格字面量的键可以使用Lua语言的关键字，而无需转义： + +```moonscript +tbl = { + do: "某事" + end: "饥饿" +} +``` + +
+tbl = {
+  do: "某事"
+  end: "饥饿"
+}
+
+ + +如果你要构造一个由变量组成的表，并希望键与变量名相同，那么可以使用 **:** 前缀操作符： + +```moonscript +hair = "金色" +height = 200 +person = { :hair, :height, shoe_size: 40 } + +print_table :hair, :height +``` + +
+hair = "金色"
+height = 200
+person = { :hair, :height, shoe_size: 40 }
+
+print_table :hair, :height
+
+ + +如果你希望表中字段的键是某个表达式的结果，那么可以用 **[ ]** 包裹它，就像在Lua中一样。如果键中有任何特殊字符，也可以直接使用字符串字面量作为键，省略方括号。 + +```moonscript +t = { + [1 + 2]: "你好" + "你好 世界": true +} +``` + +
+t = {
+  [1 + 2]: "你好"
+  "你好 世界": true
+}
+
+ + +## 推导式 + +推导式为我们提供了一种便捷的语法，通过遍历现有对象并对其值应用表达式来构造出新的表格。月之脚本有两种推导式：列表推导式和表格推导式。它们最终都是产生Lua表格；列表推导式将值累积到类似数组的表格中，而表格推导式允许您在每次遍历时设置新表格的键和值。 + +### 列表推导式 + +以下操作创建了一个items表的副本，但所有包含的值都翻倍了。 + +```moonscript +items = { 1, 2, 3, 4 } +doubled = [item * 2 for i, item in ipairs items] +``` + +
+items = { 1, 2, 3, 4 }
+doubled = [item * 2 for i, item in ipairs items]
+
+ + +可以使用when子句筛选新表中包含的项目： + +```moonscript +iter = ipairs items +slice = [item for i, item in iter when i > 1 and i < 3] +``` + +
+iter = ipairs items
+slice = [item for i, item in iter when i > 1 and i < 3]
+
+ + +因为我们常常需要迭代数值索引表的值，所以引入了**\***操作符来做语法简化。doubled示例可以重写为： + +```moonscript +doubled = [item * 2 for item in *items] +``` + +
+doubled = [item * 2 for item in *items]
+
+ + +for和when子句可以根据需要进行链式操作。唯一的要求是推导式中至少要有一个for子句。 + +使用多个for子句与使用多重循环的效果相同： + +```moonscript +x_coords = {4, 5, 6, 7} +y_coords = {9, 2, 3} + +points = [{x, y} for x in *x_coords \ +for y in *y_coords] +``` + +
+x_coords = {4, 5, 6, 7}
+y_coords = {9, 2, 3}
+
+points = [{x, y} for x in *x_coords \
+for y in *y_coords]
+
+ + +在推导式中也可以使用简单的数值for循环： + +```moonscript +evens = [i for i = 1, 100 when i % 2 == 0] +``` + +
+evens = [i for i = 1, 100 when i % 2 == 0]
+
+ + +### 表格推导式 + +表格推导式和列表推导式的语法非常相似，只是要使用 **{** 和 **}** 并从每次迭代中取两个值。 + +以下示例生成了表格thing的副本： + +```moonscript +thing = { + color: "red" + name: "fast" + width: 123 +} + +thing_copy = {k, v for k, v in pairs thing} +``` + +
+thing = {
+  color: "red"
+  name: "fast"
+  width: 123
+}
+
+thing_copy = {k, v for k, v in pairs thing}
+
+ + +```moonscript +no_color = {k, v for k, v in pairs thing when k != "color"} +``` + +
+no_color = {k, v for k, v in pairs thing when k != "color"}
+
+ + +**\***操作符在表格推导式中能使用。在下面的例子里，我们为几个数字创建了一个平方根查找表。 + +```moonscript +numbers = {1, 2, 3, 4} +sqrts = {i, math.sqrt i for i in *numbers} +``` + +
+numbers = {1, 2, 3, 4}
+sqrts = {i, math.sqrt i for i in *numbers}
+
+ + +表格推导式中的键值元组也可以来自单个表达式，在这种情况下，表达式在计算后应返回两个值。第一个用作键，第二个用作值： + +在下面的示例中，我们将一些数组转换为一个表，其中每个数组里的第一项是键，第二项是值。 + +```moonscript +tuples = {{"hello", "world"}, {"foo", "bar"}} +tbl = {unpack tuple for tuple in *tuples} +``` + +
+tuples = { {"hello", "world"}, {"foo", "bar"} }
+tbl = {unpack tuple for tuple in *tuples}
+
+ + +### 切片 + +当使用 **\*** 操作符时，月之脚本还提供了一种特殊的语法来限制要遍历的列表范围。这个语法也相当于在for循环中设置迭代边界和步长。 + +下面的案例中，我们在切片中设置最小和最大边界，取索引在1到5之间（包括1和5）的所有项目： + +```moonscript +slice = [item for item in *items[1, 5]] +``` + +
+slice = [item for item in *items[1, 5]]
+
+ + +切片的任意参数都可以省略，并会使用默认值。在如下示例中，如果省略了最大索引边界，它默认为表的长度。使下面的代码取除第一个元素之外的所有元素： + +```moonscript +slice = [item for item in *items[2,]] +``` + +
+slice = [item for item in *items[2,]]
+
+ + +如果省略了最小边界，便默认会设置为1。这里我们只提供一个步长，并留下其他边界为空。这样会使得代码取出所有奇数索引的项目：(1, 3, 5, …) + +```moonscript +slice = [item for item in *items[,,2]] +``` + +
+slice = [item for item in *items[,,2]]
+
+ + +## For 循环 + +Lua中有两种for循环形式，数字型和通用型： + +```moonscript +for i = 10, 20 + print i + +for k = 1, 15, 2 -- 提供了一个遍历的步长 + print k + +for key, value in pairs object + print key, value +``` + +
+for i = 10, 20
+  print i
+
+for k = 1, 15, 2 -- 提供了一个遍历的步长
+  print k
+
+for key, value in pairs object
+  print key, value
+
+ + +可以使用切片和**\***操作符，就像在列表推导中一样： + +```moonscript +for item in *items[2, 4] + print item +``` + +
+for item in *items[2, 4]
+  print item
+
+ + +当代码语句只有一行时，循环语句也都可以写作更短的语法： + +```moonscript +for item in *items do print item + +for j = 1, 10, 3 do print j +``` + +
+for item in *items do print item
+
+for j = 1, 10, 3 do print j
+
+ + +for循环也可以用作表达式。for循环主体中的最后一条语句会被强制转换为一个返回值的表达式，并会将表达式计算结果的值追加到一个作为结果的数组表中。 + +将每个偶数加倍： + +```moonscript +doubled_evens = for i = 1, 20 + if i % 2 == 0 + i * 2 + else + i +``` + +
+doubled_evens = for i = 1, 20
+  if i % 2 == 0
+    i * 2
+  else
+    i
+
+ + +您还可以结合for循环表达式与continue语句来过滤值。 + +注意出现在函数体末尾的for循环，不会被当作是一个表达式，并将循环结果累积到一个列表中作为返回值（相反，函数将返回nil）。如果要函数末尾的循环转换为列表表达式，可以使用返回语句加for循环表达式。 + +```moonscript +func_a = -> for i = 1, 10 do print i +func_b = -> return for i = 1, 10 do i + +print func_a! -- 打印 nil +print func_b! -- 打印 table 对象 +``` + +
+func_a = -> for i = 1, 10 do print i
+func_b = -> return for i = 1, 10 do i
+
+print func_a! -- 打印 nil
+print func_b! -- 打印 table 对象
+
+ + +这样做是为了避免在不需要返回循环结果的函数，创建无效的返回值表格。 + +## Repeat 循环 + +repeat循环是从Lua语言中搬过来的相似语法： + +```moonscript +i = 10 +repeat + print i + i -= 1 +until i == 0 +``` + +
+i = 10
+repeat
+  print i
+  i -= 1
+until i == 0
+
+ + +## While 循环 + +在月之脚本中的while循环有四种写法： + +```moonscript +i = 10 +while i > 0 + print i + i -= 1 + +while running == true do my_function! +``` + +
+i = 10
+while i > 0
+  print i
+  i -= 1
+
+while running == true do my_function!
+
+ + +```moonscript +i = 10 +until i == 0 + print i + i -= 1 + +until running == false do my_function! +``` + +
+i = 10
+until i == 0
+  print i
+  i -= 1
+until running == false do my_function!
+
+ + +像for循环的语法一样，while循环也可以作为一个表达式使用。为了使函数返回while循环的累积列表值，必须明确使用返回语句返回while循环表达式。 + +## 继续 + +继续语句可以用来跳出当前的循环迭代。 + +```moonscript +i = 0 +while i < 10 + i += 1 + continue if i % 2 == 0 + print i +``` + +
+i = 0
+while i < 10
+  i += 1
+  continue if i % 2 == 0
+  print i
+
+ + +继续语句也可以与各种循环表达式一起使用，以防止当前的循环迭代结果累积到结果列表中。以下示例将数组表过滤为仅包含偶数的数组： + +```moonscript +my_numbers = {1, 2, 3, 4, 5, 6} +odds = for x in *my_numbers + continue if x % 2 == 1 + x +``` + +
+my_numbers = {1, 2, 3, 4, 5, 6}
+odds = for x in *my_numbers
+  continue if x % 2 == 1
+  x
+
+ + +## 条件语句 + +```moonscript +have_coins = false +if have_coins + print "有硬币" +else + print "没有硬币" +``` + +
+have_coins = false
+if have_coins
+  print "有硬币"
+else
+  print "没有硬币"
+
+ + +对于简单的语句，也可以使用简短的语法： + +```moonscript +have_coins = false +if have_coins then print "有硬币" else print "没有硬币" +``` + +
+have_coins = false
+if have_coins then print "有硬币" else print "没有硬币"
+
+ + +因为if语句可以用作表达式，所以也可以这样写： + +```moonscript +have_coins = false +print if have_coins then "有硬币" else "没有硬币" +``` + +
+have_coins = false
+print if have_coins then "有硬币" else "没有硬币"
+
+ + +条件语句也可以作为表达式用在返回语句和赋值语句中： + +```moonscript +is_tall = (name) -> + if name == "Rob" + true + else + false + +message = if is_tall "Rob" + "我很高" +else + "我不是很高" + +print message -- 打印: 我很高 +``` + +
+is_tall = (name) ->
+  if name == "Rob"
+    true
+  else
+    false
+
+message = if is_tall "Rob"
+  "我很高"
+else
+  "我不是很高"
+
+print message -- 打印: 我很高
+
+ + +if的反义词是unless（相当于if not，如果 vs 除非）： + +```moonscript +unless os.date("%A") == "Monday" + print "今天不是星期一！" +``` + +
+unless os.date("%A") == "Monday"
+  print "今天不是星期一！"
+
+ + +```moonscript +print "你真幸运！" unless math.random! > 0.1 +``` + +
+print "你真幸运！" unless math.random! > 0.1
+
+ + +### 范围表达式 + +您可以使用范围表达式来编写进行边界范围检查的代码。 + +```moonscript +a = 5 + +if a in [1, 10] + print "a在1到10的范围内" + +if a not in [1, 10] + print "a不在1到10的范围内" + +if a in (0, 11) + print "a在0到11的开放区间内" + +if a in {1, 3, 5, 7} + print "检查离散值的相等性" + +if a in list + print "检查`a`是否在列表中" +``` + +
+a = 5
+
+if a in [1, 10]
+  print "a在1到10的范围内"
+
+if a not in [1, 10]
+  print "a不在1到10的范围内"
+
+if a in (0, 11)
+  print "a在0到11的开放区间内"
+
+if a in {1, 3, 5, 7}
+  print "检查离散值的相等性"
+
+if a in list
+  print "检查`a`是否在列表中"
+
+ + +```moonscript +print "你很幸运!" unless math.random! > 0.1 +``` + +
+print "你很幸运!" unless math.random! > 0.1
+
+ + +## 代码行修饰符 + +为了方便编写代码，循环语句和if语句可以应用于单行代码语句的末尾： + +```moonscript +print "你好，世界" if name == "Rob" +``` + +
+print "你好，世界" if name == "Rob"
+
+ + +修饰for循环的示例： + +```moonscript +print "项目: ", item for item in *items +``` + +
+print "项目: ", item for item in *items
+
+ + +修饰while循环的示例： + +```moonscript +game\update! while game\isRunning! + +reader\parse_line! until reader\eof! +``` + +
+game\update! while game\isRunning!
+
+reader\parse_line! until reader\eof!
+
+ + +## Switch 语句 + +switch语句是为了简化检查一系列相同值的if语句而提供的简写语法。要注意用于比较检查的目标值只会计算一次。和if语句一样，switch语句在最后可以接一个else代码块来处理没有匹配的情况。在生成的Lua代码中，进行比较是使用==操作符完成的。 + +```moonscript +name = "Dan" +switch name + when "Robert" + print "你是Robert" + when "Dan", "Daniel" + print "你的名字是Dan" + else + print "我不知道你的名字" +``` + +
+name = "Dan"
+switch name
+  when "Robert"
+    print "你是Robert"
+  when "Dan", "Daniel"
+    print "你的名字是Dan"
+  else
+    print "我不知道你的名字"
+
+ + +switch语句的when子句中可以通过使用逗号分隔的列表来匹配多个值。 + +switch语句也可以作为表达式使用，下面我们可以将switch语句返回的结果分配给一个变量： + +```moonscript +b = 1 +next_number = switch b + when 1 + 2 + when 2 + 3 + else + error "数字数得太大了！" +``` + +
+b = 1
+next_number = switch b
+  when 1
+    2
+  when 2
+    3
+  else
+    error "数字数得太大了！"
+
+ + +我们可以使用then关键字在when子句的同一行上编写处理代码。else代码块的后续代码中要写在同一行上不需要额外的关键字。 + +```moonscript +msg = switch math.random(1, 5) + when 1 then "你很幸运" + when 2 then "你差点很幸运" + else "不太幸运" +``` + +
+msg = switch math.random(1, 5)
+  when 1 then "你很幸运"
+  when 2 then "你差点很幸运"
+  else "不太幸运"
+
+ + +如果在编写switch语句时希望少写一个缩进，那么你可以把第一个when子句放在switch开始语句的第一行，然后后续的子语句就都可以都少写一个缩进。 + +```moonscript +switch math.random(1, 5) + when 1 + print "你很幸运" -- 两个缩进级别 + else + print "不太幸运" + +switch math.random(1, 5) when 1 + print "你很幸运" -- 一个缩进级别 +else + print "不太幸运" +``` + +
+switch math.random(1, 5)
+  when 1
+    print "你很幸运" -- 两个缩进级别
+  else
+    print "不太幸运"
+
+switch math.random(1, 5) when 1
+  print "你很幸运" -- 一个缩进级别
+else
+  print "不太幸运"
+
+ + +值得注意的是，在生成Lua代码时，我们要做检查的目标变量会放在==表达式的右侧。当您希望给when子句的比较对象定义一个\_\_eq元方法来重载判断逻辑时，可能会有用。 + +### 表格匹配 + +在switch的when子句中，如果期待检查目标是一个表格，且可以通过特定的结构进行解构并获得非nil值，那么你可以尝试使用表格匹配的语法。 + +```moonscript +items = + * x: 100 + y: 200 + * width: 300 + height: 400 + +for item in *items + switch item + when :x, :y + print "Vec2 #{x}, #{y}" + when :width, :height + print "尺寸 #{width}, #{height}" +``` + +
+items =
+  * x: 100
+    y: 200
+  * width: 300
+    height: 400
+
+for item in *items
+  switch item
+    when :x, :y
+      print "Vec2 #{x}, #{y}"
+    when :width, :height
+      print "尺寸 #{width}, #{height}"
+
+ + +你可以使用默认值来选择性地解构表格的某些字段。 + +```moonscript +item = {} + +{pos: {:x = 50, :y = 200}} = item -- 获取错误：尝试索引nil值（字段'pos'） + +switch item + when {pos: {:x = 50, :y = 200}} + print "Vec2 #{x}, #{y}" -- 表格解构仍然会通过 +``` + +
+item = {}
+
+{pos: {:x = 50, :y = 200}} = item -- 获取错误：尝试索引nil值（字段'pos'）
+
+switch item
+  when {pos: {:x = 50, :y = 200}}
+    print "Vec2 #{x}, #{y}" -- 表格解构仍然会通过
+
+ + +### 范围匹配 + +使用`in`范围匹配表达式，你可以在switch的when子句中进行范围匹配的检查处理。 + +```moonscript +value = 5 + +switch item + -- 使用闭区间进行范围检查 + when in [1, 3] + print "1 <= value <= 3" + + -- 使用开闭区间进行范围检查 + when in (6, 8] + print "6 < value <= 8" + + -- 检查不在范围内 + when not in [1, 10) + print "不是 (1 <= value < 10)" + + -- 检查离散值 + when in {11, 21, 99} + print "值是 11, 21 或 99" +``` + +
+value = 5
+
+switch item
+  -- 使用闭区间进行范围检查
+  when in [1, 3]
+    print "1 <= value <= 3"
+
+  -- 使用开闭区间进行范围检查
+  when in (6, 8]
+    print "6 < value <= 8"
+
+  -- 检查不在范围内
+  when not in [1, 10)
+    print "不是 (1 <= value < 10)"
+
+  -- 检查离散值
+  when in {11, 21, 99}
+    print "值是 11, 21 或 99"
+
+ + +## 面向对象编程 + +在以下的示例中，月之脚本生成的Lua代码可能看起来会很复杂。所以最好主要关注月之脚本代码层面的意义，然后如果您想知道关于面向对象功能的实现细节，再查看Lua代码。 + +一个简单的类： + +```moonscript +class Inventory + new: => + @items = {} + + add_item: (name)=> + if @items[name] + @items[name] += 1 + else + @items[name] = 1 +``` + +
+class Inventory
+  new: =>
+    @items = {}
+
+  add_item: (name)=>
+    if @items[name]
+      @items[name] += 1
+    else
+      @items[name] = 1
+
+ + +月之脚本面向对象的写法是使用类的声明语句，然后跟一个Lua表格字面量的声明来声明一个类，并在表格定义中列出所有的方法和属性。 + +键名为new的成员在这里很特殊，因为它会被用作构造函数。 + +注意类中的所有方法都使用了粗箭头函数语法。在调用类的实例上的方法时，实例本身会作为第一个参数传入。所以粗箭头的函数负责创建一个self参数。 + +变量名上的@前缀是self的简写。@items会变为self.items。 + +在创建类的实例时，可以通过把类的名称作为函数进行调用，并获得新的实例。 + +```moonscript +inv = Inventory! +inv\add_item "t-shirt" +inv\add_item "pants" +``` + +
+inv = Inventory!
+inv\add_item "t-shirt"
+inv\add_item "pants"
+
+ + +因为需要将类的实例传入到它们被调用的方法，所以使用了\操作符。 + +类的所有属性在实例之间是共享的。对于函数来说一般没有问题，但是对于其他类型的属性，可能会出现不希望的结果。 + +比如下面的例子，clothes属性在所有实例之间是共享的，所以在一个实例中对它的修改会影响到另一个实例： + +```moonscript +class Person + clothes: {} + give_item: (name)=> + table.insert @clothes, name + +a = Person! +b = Person! + +a\give_item "pants" +b\give_item "shirt" + +-- 会同时打印出裤子和衬衫 +print item for item in *a.clothes +``` + +
+class Person
+  clothes: {}
+  give_item: (name)=>
+    table.insert @clothes, name
+
+a = Person!
+b = Person!
+
+a\give_item "pants"
+b\give_item "shirt"
+
+-- 会同时打印出裤子和衬衫
+print item for item in *a.clothes
+
+ + +避免这个问题的正确方法是在构造函数中创建对象的可变状态： + +```moonscript +class Person + new: => + @clothes = {} +``` + +
+class Person
+  new: =>
+    @clothes = {}
+
+ + +### 继承 + +`extends`关键字可以在类声明中使用，以继承另一个类的属性和方法。 + +```moonscript +class BackPack extends Inventory + size: 10 + add_item: (name)=> + if #@items > size then error "背包已满" + super name +``` + +
+class BackPack extends Inventory
+  size: 10
+  add_item: (name)=>
+    if #@items > size then error "背包已满"
+    super name
+
+ + +这里我们扩展了Inventory类，并限制了它可以携带的物品数量。 + +在这个例子中，我们没有在子类上定义构造函数，所以当我们创建一个新实例时，会调用父类的构造函数。如果我们定义了构造函数，那么我们可以使用super方法来调用父类的构造函数。 + +每当一个类从另一个类继承时，它会通过调用父类上的`__inherited`方法（如果存在）向父类发送消息。该函数接收两个参数，被继承的类和子类。 + +```moonscript +class Shelf + @__inherited: (child)=> + print @__name, "被", child.__name, "继承" + +-- 将打印: Shelf 被 Cupboard 继承 +class Cupboard extends Shelf +``` + +
+class Shelf
+  @__inherited: (child)=>
+    print @__name, "被", child.__name, "继承"
+
+-- 将打印: Shelf 被 Cupboard 继承
+class Cupboard extends Shelf
+
+ + +### Super 关键字 + +**super** 是一个特殊的关键字，可以用两种不同的方式使用：它可以被视为一个对象，或者可以像函数一样被调用。它只在类的内部出现时有特殊功能。 + +当作为函数调用时，它会调用父类中同名的函数。当前的 self 会自动作为第一个参数进行传递。（如上面的继承示例所示） + +当 super 被用作普通值时，它是对父类对象的引用。 + +它可以像访问任何普通对象一样来检索父类中可能被子类覆盖的值。 + +当使用 \ 调用操作符与 super 一起使用时，self 会被插入为第一个参数，而不是 super 本身的值。当使用 . 来检索函数时，会返回父类中的原始函数。 + +以下是使用 super 的几个不同方式的示例： + +```moonscript +class MyClass extends ParentClass + a_method: => + -- 以下效果相同： + super "你好", "世界" + super\a_method "你好", "世界" + super.a_method self, "你好", "世界" + + -- super 作为值等于父类： + assert super == ParentClass +``` + +
+class MyClass extends ParentClass
+  a_method: =>
+    -- 以下效果相同：
+    super "你好", "世界"
+    super\a_method "你好", "世界"
+    super.a_method self, "你好", "世界"
+
+    -- super 作为值等于父类：
+    assert super == ParentClass
+
+ + +**super** 也可以用在函数存根的左侧。唯一的主要区别是，生成的函数不是绑定到 super 的值，而是绑定到 self。 + +### 类型 + +每个类的实例都带有它的类型。这存储在特殊的 \_\_class 属性中。此属性会保存类对象。类对象是我们用来构建新实例的对象。我们还可以索引类对象以检索类方法和属性。 + +```moonscript +b = BackPack! +assert b.__class == BackPack + +print BackPack.size -- 打印 10 +``` + +
+b = BackPack!
+assert b.__class == BackPack
+
+print BackPack.size -- 打印 10
+
+ + +### 类对象 + +当我们使用类的定义语句时，我们创建的是类对象。类对象存储在与类同名的变量中。 + +类对象可以像函数一样被调用，以创建新的实例。这就是我们在上面的例子中如何创建类的实例的。 + +一个类由两个表组成。类表本身和基表。基表用作所有实例的元表。在类声明中列出的所有属性都会被放在基表中。 + +如果类对象的元表中不存在属性，它会从基表中读取属性。这意味着我们可以直接从类中访问函数和属性。 + +重要的是要注意，赋值给类对象并不会赋值给基表，所以这不是向实例添加新方法的有效方式。相反，必须明确地更改基表。参见下面的 \_\_base 字段。 + +类对象有几个特殊的属性： + +当它被声明时，类的名称存储为类对象的 \_\_name 字段中的字符串。 + +```moonscript +print BackPack.__name -- 打印 Backpack +``` + +
+print BackPack.__name -- 打印 Backpack
+
+ + +基对象存储在 \_\_base 中。我们可以修改这个表，为已经创建的实例和尚未创建的实例添加功能。 + +如果类从其他类扩展，父类对象存储在 \_\_parent 中。 + +### 类变量 + +我们可以直接在类对象中创建变量，而不是在类的基对象中，通过在类声明中的属性名前使用 @。 + +```moonscript +class Things + @some_func: => print "Hello from", @__name + +Things\some_func! + +-- 类变量在实例中不可见 +assert Things().some_func == nil +``` + +
+class Things
+  @some_func: => print "Hello from", @__name
+
+Things\some_func!
+
+-- 类变量在实例中不可见
+assert Things().some_func == nil
+
+ + +在表达式中，我们可以使用 @@ 来访问存储在 self.__class 中的值。因此，@@hello 是 self.__class.hello 的简写。 + +```moonscript +class Counter + @count: 0 + + new: => + @@count += 1 + +Counter! +Counter! + +print Counter.count -- 输出 2 +``` + +
+class Counter
+  @count: 0
+
+  new: =>
+    @@count += 1
+
+Counter!
+Counter!
+
+print Counter.count -- 输出 2
+
+ + +@@ 的调用语义与 @ 类似。调用 @@ 时，会使用 Lua 的冒号语法将类作为第一个参数传入。 + +```moonscript +@@hello 1,2,3,4 +``` + +
+@@hello 1,2,3,4
+
+ + +### 类声明语句 + +在类声明的主体中，除了键/值对外，我们还可以编写普通的表达式。在这种类声明体中的普通代码的上下文中，self等于类对象，而不是实例对象。 + +以下是创建类变量的另一种方法： + +```moonscript +class Things + @class_var = "hello world" +``` + +
+class Things
+  @class_var = "hello world"
+
+ + +这些表达式会在所有属性被添加到类的基对象后执行。 + +在类的主体中声明的所有变量都会限制作用域只在类声明的范围。这对于放置只有类方法可以访问的私有值或辅助函数很方便： + +```moonscript +class MoreThings + secret = 123 + log = (msg)-> print "LOG:", msg + + some_method: => + log "hello world: " .. secret +``` + +
+class MoreThings
+  secret = 123
+  log = (msg)-> print "LOG:", msg
+
+  some_method: =>
+    log "hello world: " .. secret
+
+ + +### @ 和 @@ 值 + +当@和@@前缀在一个名字前时，它们分别代表在self和self.\_\_class中访问的那个名字。 + +如果它们单独使用，它们是self和self.\_\_class的别名。 + +```moonscript +assert @ == self +assert @@ == self.__class +``` + +
+assert @ == self
+assert @@ == self.__class
+
+ + +例如，使用@@从实例方法快速创建同一类的新实例的方法： + +```moonscript +some_instance_method = (...)=> @@ ... +``` + +
+some_instance_method = (...)=> @@ ...
+
+ + +### 构造属性提升 + +为了减少编写简单值对象定义的代码。你可以这样简单写一个类： + +```moonscript +class Something + new: (@foo, @bar, @@biz, @@baz) => + +-- 这是以下声明的简写形式 + +class Something + new: (foo, bar, biz, baz) => + @foo = foo + @bar = bar + @@biz = biz + @@baz = baz +``` + +
+class Something
+  new: (@foo, @bar, @@biz, @@baz) =>
+
+-- 这是以下声明的简写形式
+
+class Something
+  new: (foo, bar, biz, baz) =>
+    @foo = foo
+    @bar = bar
+    @@biz = biz
+    @@baz = baz
+
+ + +你也可以使用这种语法为一个函数初始化传入对象的字段。 + +```moonscript +new = (@fieldA, @fieldB)=> @ +obj = new {}, 123, "abc" +print obj +``` + +
+new = (@fieldA, @fieldB)=> @
+obj = new {}, 123, "abc"
+print obj
+
+ + +### 类表达式 + +类声明的语法也可以作为一个表达式使用，可以赋值给一个变量或者被返回语句返回。 + +```moonscript +x = class Bucket + drops: 0 + add_drop: => @drops += 1 +``` + +
+x = class Bucket
+  drops: 0
+  add_drop: => @drops += 1
+
+ + +### 匿名类 + +声明类时可以省略名称。如果类的表达式不在赋值语句中，\_\_name属性将为nil。如果出现在赋值语句中，赋值操作左侧的名称将代替nil。 + +```moonscript +BigBucket = class extends Bucket + add_drop: => @drops += 10 + +assert Bucket.__name == "BigBucket" +``` + +
+BigBucket = class extends Bucket
+  add_drop: => @drops += 10
+
+assert Bucket.__name == "BigBucket"
+
+ + +你甚至可以省略掉主体，这意味着你可以这样写一个空白的匿名类： + +```moonscript +x = class +``` + +
+x = class
+
+ + +### 类混合 + +您可以使用关键字 `using` 进行类混合，从一个普通表或预定义的类对象中复制函数到您的新类中。当使用普通表进行混合时，您可以将比如类的索引方法（元方法 `__index`）重写为您的自定义实现。当混合使用的目标是一个类对象时，类对象的元方法不会被复制到新的类中。 + +```moonscript +MyIndex = __index: var: 1 + +class X using MyIndex + func: => + print 123 + +x = X! +print x.var + +class Y using X + +y = Y! +y\func! + +assert y.__class.__parent ~= X -- X 不是 Y 的父类 +``` + +
+MyIndex = __index: var: 1
+
+class X using MyIndex
+  func: =>
+    print 123
+
+x = X!
+print x.var
+
+class Y using X
+
+y = Y!
+y\func!
+
+assert y.__class.__parent ~= X -- X 不是 Y 的父类
+
+ + +## With 语句 + +在编写Lua代码时，我们在创建对象后的常见操作是立即调用这个对象一系列操作函数并设置一系列属性。 + +这导致在代码中多次重复引用对象的名称，增加了不必要的文本噪音。一个常见的解决方案是在创建对象时，在构造函数传入一个表，该表包含要覆盖设置的键和值的集合。这样做的缺点是该对象的构造函数必须支持这种初始化形式。 + +with块有助于简化编写这样的代码。在with块内，我们可以使用以.或\开头的特殊语句，这些语句代表我们正在使用的对象的操作。 + +例如，我们可以这样处理一个新创建的对象： + +```moonscript +with Person! + .name = "Oswald" + \add_relative my_dad + \save! + print .name +``` + +
+with Person!
+  .name = "Oswald"
+  \add_relative my_dad
+  \save!
+  print .name
+
+ + +with语句也可以用作一个表达式，并返回它的代码块正在处理的对象。 + +```moonscript +file = with File "favorite_foods.txt" + \set_encoding "utf8" +``` + +
+file = with File "favorite_foods.txt"
+  \set_encoding "utf8"
+
+ + +或者… + +```moonscript +create_person = (name, relatives)-> + with Person! + .name = name + \add_relative relative for relative in *relatives + +me = create_person "Leaf", {dad, mother, sister} +``` + +
+create_person = (name,  relatives)->
+  with Person!
+    .name = name
+    \add_relative relative for relative in *relatives
+
+me = create_person "Leaf", {dad, mother, sister}
+
+ + +在此用法中，with可以被视为K组合子（k-combinator）的一种特殊形式。 + +如果您想给表达式另外起一个名称的话，with语句中的表达式也可以是一个赋值语句。 + +```moonscript +with str = "你好" + print "原始:", str + print "大写:", \upper! +``` + +
+with str = "你好"
+  print "原始:", str
+  print "大写:", \upper!
+
+ + +在with语句中可以使用`[]`访问特殊键。 + +```moonscript +with tb + [1] = 1 + print [2] + with [abc] + [3] = [2]\func! + ["key-name"] = value + [] = "abc" -- 追加到 "tb" +``` + +
+with tb
+  [1] = 1
+  print [2]
+  with [abc]
+    [3] = [2]\func!
+    ["key-name"] = value
+  [] = "abc" -- 追加到 "tb"
+
+ + +## do 语句 + +当用作语句时，do语句的作用就像在Lua中差不多。 + +```moonscript +do + var = "hello" + print var +print var -- 这里是nil +``` + +
+do
+  var = "hello"
+  print var
+print var -- 这里是nil
+
+ + +月之脚本的 **do** 也可以用作表达式。允许您将多行代码的处理合并为一个表达式，并将do语句代码块的最后一个语句作为表达式返回的结果。 + +```moonscript +counter = do + i = 0 + -> + i += 1 + i + +print counter! +print counter! +``` + +
+counter = do
+  i = 0
+  ->
+    i += 1
+    i
+
+print counter!
+print counter!
+
+ + +```moonscript +tbl = { + key: do + print "分配键值!" + 1234 +} +``` + +
+tbl = {
+  key: do
+    print "分配键值!"
+    1234
+}
+
+ + +## 函数存根 + +将对象的函数作为值传递是很常见的，例如，将实例方法传递给函数作为回调。如果函数期望它操作的对象作为第一个参数，那么您必须以某种方式将该对象与函数捆绑在一起，以便可以正确地调用它。 + +函数存根语法是创建一个新的闭包函数的简写，该函数将对象和函数都捆绑在一起。这个新函数在对象的正确上下文中调用被包装的函数。 + +其语法与使用\操作符调用实例方法相同，但不用在后面接着提供参数列表。 + +```moonscript +my_object = { + value: 1000 + write: => print "值为:", @value +} + +run_callback = (func)-> + print "运行回调..." + func! + +-- 这样写不起作用： +-- 函数没有引用my_object +run_callback my_object.write + +-- 函数存根语法 +-- 让我们把对象捆绑到一个新函数中 +run_callback my_object\write +``` + +
+my_object = {
+  value: 1000
+  write: => print "值为:", @value
+}
+
+run_callback = (func)->
+  print "运行回调..."
+  func!
+
+-- 这样写不起作用：
+-- 函数没有引用my_object
+run_callback my_object.write
+
+-- 函数存根语法
+-- 让我们把对象捆绑到一个新函数中
+run_callback my_object\write
+
+ + +## Using 语句：避免有破坏性的赋值 + +虽然Lua的变量作用域可以在减少我们编写的代码的复杂性上提供很大的帮助，但随着代码量的增加，事情可能会变得难以管理。考虑以下代码片段： + +```moonscript +i = 100 + +-- 许多代码行... + +my_func = -> + i = 10 + while i > 0 + print i + i -= 1 + +my_func! + +print i -- 将打印 0 +``` + +
+i = 100
+
+-- 许多代码行...
+
+my_func = ->
+  i = 10
+  while i > 0
+    print i
+    i -= 1
+
+my_func!
+
+print i -- 将打印 0
+
+ + +在my_func中，我们错误地覆盖了i的值。在例子中的这个问题很明显，但考虑一个大的或外部的代码库，会很容易不清楚之前已经声明了哪些名称。 + +如果能指定我们只打算更改的封闭作用域中的变量，并防止我们意外地更改其他作用域的同名变量，那将会很有帮助。 + +using语句让我们能够做到这一点。using nil确保在一个函数里的赋值中不会覆盖外部的变量。我们只要把using子句放在函数的参数列表之后，或者当函数没有参数，就直接放在括号里。 + +```moonscript +i = 100 + +my_func = (using nil)-> + i = "hello" -- 这里创建了一个新的局部变量 + +my_func! +print i -- 打印 100，i 没有受到影响 +``` + +
+i = 100
+
+my_func = (using nil)->
+  i = "hello" -- 这里创建了一个新的局部变量
+
+my_func!
+print i -- 打印 100，i 没有受到影响
+
+ + +using子句中可以填写多个用逗号分隔名称。指定可以访问和修改的外部变量的名称： + +```moonscript +tmp = 1213 +i, k = 100, 50 + +my_func = (add using k, i)-> + tmp = tmp + add -- 创建了一个新的局部tmp + i += tmp + k += tmp + +my_func(22) +print i, k -- 这些已经被更新 +``` + +
+tmp = 1213
+i, k = 100, 50
+
+my_func = (add using k, i)->
+  tmp = tmp + add -- 创建了一个新的局部tmp
+  i += tmp
+  k += tmp
+
+my_func(22)
+print i, k -- 这些已经被更新
+
+ + +## MIT 许可证 + +版权 (c) 2023 李瑾 + +特此免费授予任何获得本软件副本和相关文档文件（下称“软件”）的人不受限制地处置该软件的权利，包括不受限制地使用、复制、修改、合并、发布、分发、转授许可和/或出售该软件副本，以及再授权被配发了本软件的人如上的权利，须在下列条件下： +上述版权声明和本许可声明应包含在该软件的所有副本或实质成分中。 +本软件是“如此”提供的，没有任何形式的明示或暗示的保证，包括但不限于对适销性、特定用途的适用性和不侵权的保证。在任何情况下，作者或版权持有人都不对任何索赔、损害或其他责任负责，无论这些追责来自合同、侵权或其它行为中，还是产生于、源于或有关于本软件以及本软件的使用或其它处置。 + + diff --git a/doc/docs/zh/try/README.md b/doc/docs/zh/try/README.md new file mode 100755 index 0000000..c42e5a9 --- /dev/null +++ b/doc/docs/zh/try/README.md @@ -0,0 +1,6 @@ +# 月之脚本的在线编译器 +--- + +在这里试试 WASM 版的 Yuescript 吧。 + + -- cgit v1.2.3-55-g6feb