@@ -8,27 +8,27 @@ assert =
88cgopt .collect =
99' 做一次完整的垃圾回收循環。 '
1010cgopt .stop =
11- ' 停止垃圾回收的執行 。 '
11+ ' 停止垃圾回收器的執行 。 '
1212cgopt .restart =
13- ' 重啟垃圾回收的自動執行 。 '
13+ ' 重啟垃圾回收器的自動執行 。 '
1414cgopt .count =
15- ' 以K 字元數為單位回傳Lua 使用的總記憶體量 。 '
15+ ' 以K 位元組數為單位回傳Lua 使用的總記憶體數 。 '
1616cgopt .step =
17- ' 單步執行垃圾回收 。步長“大小”由`arg` 控制。 '
17+ ' 單步執行垃圾回收器 。步長“大小”由`arg` 控制。 '
1818cgopt .setpause =
19- ' 將`arg` 設為垃圾回收的 *間歇率* 。 '
19+ ' 將`arg` 設為回收器的 *間歇率* 。 '
2020cgopt .setstepmul =
21- ' 將`arg` 設為垃圾回收的 *步進倍率* 。 '
21+ ' 將`arg` 設為回收器的 *步進倍率* 。 '
2222cgopt .incremental =
23- ' 改變垃圾回收模式為增量模式 。 '
23+ ' 改變回收器模式為增量模式 。 '
2424cgopt .generational =
25- ' 改變垃圾回收模式為分代模式 。 '
25+ ' 改變回收器模式為分代模式 。 '
2626cgopt .isrunning =
27- ' 回傳表示垃圾回收是否在工作的布林值 。 '
27+ ' 回傳表示回收器是否在工作的布林值 。 '
2828collectgarbage =
29- ' 這個函式是垃圾回收的通用介面 。通過參數opt 它提供了一組不同的功能。 '
29+ ' 這個函式是垃圾回收器的通用介面 。通過參數opt 它提供了一組不同的功能。 '
3030dofile =
31- ' 打開該名字的檔案,並執行檔案中的Lua 程式碼區塊。不帶參數呼叫時, `dofile` 執行標準輸入的內容(`stdin`)。回傳該程式碼區塊的所有回傳值。對於有錯誤的情況,`dofile` 將錯誤反饋給呼叫者(即,`dofile` 沒有在保護模式下執行 )。 '
31+ ' 打開該名字的檔案,並執行檔案中的Lua 程式碼區塊。不帶參數呼叫時, `dofile` 執行標準輸入的內容(`stdin`)。回傳該程式碼區塊的所有回傳值。對於有錯誤的情況,`dofile` 將錯誤反饋給呼叫者(即,`dofile` 沒有執行在保護模式下 )。 '
3232error =
3333[[
3434中止上一次保護函式呼叫, 將錯誤對象`message` 回傳。函式`error` 永遠不會回傳。
@@ -61,7 +61,7 @@ load['>5.2'] =
6161[[
6262載入一個程式碼區塊。
6363
64- 如果`chunk` 是一個字串,程式碼區塊指這個字串。如果`chunk` 是一個函式, `load` 不斷地呼叫它獲取程式碼區塊的片段 。每次對`chunk` 的呼叫都必須回傳一個字串緊緊連接在上次呼叫的回傳之後。當回傳空字串 、`nil`、或是不回傳值時,都表示程式碼區塊結束。
64+ 如果`chunk` 是一個字串,程式碼區塊指這個字串。如果`chunk` 是一個函式, `load` 不斷地呼叫它獲取程式碼區塊的片斷 。每次對`chunk` 的呼叫都必須回傳一個字串緊緊連接在上次呼叫的回傳串之後。當回傳空串 、`nil`、或是不回傳值時,都表示程式碼區塊結束。
6565]]
6666loadfile =
6767' 從檔案`filename` 或標準輸入(如果檔名未提供)中獲取程式碼區塊。 '
7373[[
7474執行程式來走訪表中的所有域。第一個參數是要走訪的表,第二個參數是表中的某個鍵。 `next` 回傳該鍵的下一個鍵及其關聯的值。如果用`nil` 作為第二個參數呼叫`next` 將回傳初始鍵及其關聯值。當以最後一個鍵去呼叫,或是以`nil` 呼叫一張空表時, `next` 回傳`nil`。如果不提供第二個參數,將認為它就是`nil`。特別指出,你可以用`next(t)` 來判斷一張表是否是空的。
7575
76- 索引在走訪過程中的次序無定義 , 即使是數字索引也是這樣。 (如果想按數字次序走訪表 ,可以使用數字形式的`for` 。)
76+ 索引在走訪過程中的順序無定義 , 即使是數字索引也是這樣。 (如果想按數字順序走訪表 ,可以使用數字形式的`for` 。)
7777
7878當在走訪過程中你給表中並不存在的域賦值, `next` 的行為是未定義的。然而你可以去修改那些已存在的域。特別指出,你可以清除一些已存在的域。
7979]]
@@ -92,7 +92,7 @@ pairs =
9292pcall =
9393' 傳入參數,以*保護模式* 呼叫函式`f` 。這意味著`f` 中的任何錯誤不會拋出; 取而代之的是,`pcall` 會將錯誤捕獲到,並回傳一個狀態碼。第一個回傳值是狀態碼(一個布林值), 當沒有錯誤時,其為真。此時,`pcall` 同樣會在狀態碼後回傳所有呼叫的結果。在有錯誤時,`pcall` 回傳`false` 加錯誤訊息。 '
9494print =
95- ' 接收任意數量的參數,並將它們的值列印到 `stdout`。它用`tostring` 函式將每個參數都轉換為字串。 `print` 不用於做格式化輸出。僅作為看一下某個值的快捷方式。多用於除錯。完整的對輸出的控制,請使用$string.format 以及$io.write。 '
95+ ' 接收任意數量的參數,並將它們的值輸出到 `stdout`。它用`tostring` 函式將每個參數都轉換為字串。 `print` 不用於做格式化輸出。僅作為看一下某個值的快捷方式。多用於除錯。完整的對輸出的控制,請使用$string.format 以及$io.write。 '
9696rawequal =
9797' 在不觸發任何元方法的情況下檢查`v1` 是否和`v2` 相等。回傳一個布林值。 '
9898rawget =
@@ -130,14 +130,14 @@ type =
130130_VERSION =
131131' 一個包含有目前直譯器版本號的全域變數(並非函式)。 '
132132warn =
133- ' 使用所有參數組成的字串消息來發送警告 。 '
133+ ' 使用所有參數組成的字串訊息來發送警告 。 '
134134xpcall [' =5.1' ] =
135135' 傳入參數,以*保護模式* 呼叫函式`f` 。這個函式和`pcall` 類似。不過它可以額外設定一個訊息處理器`err`。 '
136136xpcall [' >5.2' ] =
137137' 傳入參數,以*保護模式* 呼叫函式`f` 。這個函式和`pcall` 類似。不過它可以額外設定一個訊息處理器`msgh`。 '
138138unpack =
139139[[
140- 回傳給定`list` 中的所有元素。該函式等價於
140+ 回傳給定`list` 中的所有元素。改函式等價於
141141```lua
142142return list[i], list[i+1], ···, list[j]
143143```
@@ -165,7 +165,7 @@ bit32.bor =
165165bit32 .btest =
166166' 參數按位與的結果不為0時,回傳`true` 。 '
167167bit32 .bxor =
168- ' 回傳參數按位互斥或的結果 。 '
168+ ' 回傳參數按位異或的結果 。 '
169169bit32 .extract =
170170' 回傳`n` 中第`field` 到第`field + width - 1` 位組成的結果。 '
171171bit32 .replace =
@@ -229,7 +229,7 @@ debug.debug =
229229debug .getfenv =
230230' 回傳對象`o` 的環境。 '
231231debug .gethook =
232- ' 回傳三個表示執行緒鉤子設定的值: 目前鉤子函式,目前鉤子掩碼 ,目前鉤子計數。 '
232+ ' 回傳三個表示執行緒鉤子設定的值: 目前鉤子函式,目前鉤子遮罩 ,目前鉤子計數。 '
233233debug .getinfo =
234234' 回傳關於一個函式訊息的表。 '
235235debug.getlocal [' <5.1' ] =
@@ -271,7 +271,7 @@ debug.setuservalue['>5.4']=
271271debug .traceback =
272272' 回傳呼叫堆疊的堆疊回溯訊息。字串可選項`message` 被添加在堆疊回溯訊息的開頭。 '
273273debug .upvalueid =
274- ' 回傳指定函式第`n` 個上值的唯一識別符 (一個輕量使用者資料)。 '
274+ ' 回傳指定函式第`n` 個上值的唯一標識符 (一個輕量使用者資料)。 '
275275debug .upvaluejoin =
276276' 讓Lua 閉包`f1` 的第`n1` 個上值引用`Lua` 閉包`f2` 的第`n2` 個上值。 '
277277infowhat .n =
@@ -339,7 +339,7 @@ seekwhence['.end'] =
339339vbuf .no =
340340' 不緩衝;輸出操作立刻生效。 '
341341vbuf .full =
342- ' 完全緩衝;只有在緩存滿或呼叫flush 時才做輸出操作。 '
342+ ' 完全緩衝;只有在快取滿或呼叫flush 時才做輸出操作。 '
343343vbuf .line =
344344' 行緩衝;輸出將緩衝到每次換行前。 '
345345
@@ -371,7 +371,7 @@ io.open =
371371io .output =
372372' 設定`file` 為預設輸出檔案。 '
373373io .popen =
374- ' 用一個分離行程開啟程式 `prog` 。 '
374+ ' 用一個分離程序開啟程式 `prog` 。 '
375375io .read =
376376' 讀檔案`file`, 指定的格式決定了要讀什麼。 '
377377io .tmpfile =
@@ -483,7 +483,7 @@ math.randomseed['>5.4'] =
483483[[
484484* `math.randomseed(x, y)`: 將`x` 與`y` 連接為128位的種子來重新初始化偽隨機生成器。
485485* `math.randomseed(x)`: 等同於`math.randomseed(x, 0)` 。
486- * `math.randomseed()`: 生成弱隨機性的種子
486+ * `math.randomseed()`: 生成一個較弱的隨機種子。
487487]]
488488math .sin =
489489' 回傳`x` 的正弦值(假定參數是弧度)。 '
@@ -513,11 +513,11 @@ os.difftime =
513513os .execute =
514514' 呼叫系統直譯器執行`command`。 '
515515os.exit [' <5.1' ] =
516- ' 呼叫C 函式`exit` 終止主機程式 。 '
516+ ' 呼叫C 函式`exit` 終止宿主程式 。 '
517517os.exit [' >5.2' ] =
518- ' 呼叫ISO C 函式`exit` 終止主機程式 。 '
518+ ' 呼叫ISO C 函式`exit` 終止宿主程式 。 '
519519os .getenv =
520- ' 回傳行程環境變數 `varname` 的值。 '
520+ ' 回傳程序環境變數 `varname` 的值。 '
521521os .remove =
522522' 刪除指定名字的檔案。 '
523523os .rename =
@@ -562,7 +562,7 @@ package.loaded =
562562package.loaders =
563563' 用於`require` 控制如何載入模組的表。 '
564564package .loadlib =
565- ' 讓主機程式動態連結C 庫`libname` 。 '
565+ ' 讓宿主程式動態連接C 庫`libname` 。 '
566566package.path =
567567' 這個路徑被`require` 在Lua 載入器中做搜尋時用到。 '
568568package.preload =
@@ -590,7 +590,7 @@ string.gmatch =
590590[[
591591回傳一個疊代器函式。每次呼叫這個函式都會繼續以`pattern` (參見§6.4.1) 對s 做匹配,並回傳所有捕獲到的值。
592592
593- 下面這個例子會循環疊代字串s 中所有的單詞, 並逐行列印 :
593+ 下面這個例子會循環疊代字串s 中所有的單詞, 並逐行輸出 :
594594```lua
595595 s =
596596"hello world from Lua"
@@ -614,7 +614,7 @@ string.packsize =
614614string.rep [' <5.1' ] =
615615' 回傳`n` 個字串`s` 連在一起的字串。如果`n` 不是正數則回傳空串。 '
616616string.rep [' >5.2' ] =
617- ' 回傳`n` 個字串`s` 以字串`sep` 為分割符連在一起的字串。預設的`sep` 值為空字串(即沒有分割符)。如果`n` 不是正數則回傳空串 。 '
617+ ' 回傳`n` 個字串`s` 以字串`sep` 為分割符連在一起的字串。預設的`sep` 值為空字串(即沒有分割符)。如果`n` 不是正數則回傳空字串 。 '
618618string .reverse =
619619' 回傳字串s 的翻轉串。 '
620620string .sub =
@@ -646,7 +646,7 @@ table.pack =
646646table .remove =
647647' 移除`list` 中`pos` 位置上的元素,並回傳這個被移除的值。 '
648648table .sort =
649- ' 在表內從`list[1]` 到`list[#list]` *原地* 對其間元素按指定次序排序 。 '
649+ ' 在表內從`list[1]` 到`list[#list]` *原地* 對其間元素按指定順序排序 。 '
650650table .unpack =
651651[[
652652回傳列表中的元素。這個函式等價於
@@ -655,13 +655,19 @@ table.unpack =
655655```
656656i 預設為1 ,j 預設為#list。
657657]]
658+ table .foreach =
659+ ' 走訪表中的每一個元素,並以key和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止,並且回傳這個值。該函式等同pair(list),比pair(list)更慢。不推薦使用'
660+ table .foreachi =
661+ ' 走訪數組中的每一個元素,並以索引號index和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止,並且回傳這個值。該函式等同ipair(list),比ipair(list)更慢。不推薦使用'
662+ table .getn =
663+ ' 回傳表的長度。該函式等價於#list。 '
658664
659665utf8 =
660666' '
661667utf8 .char =
662- ' 接收零或多個整數, 將每個整數轉換成對應的UTF-8 字元序列 ,並回傳這些序列連接到一起的字串。 '
668+ ' 接收零或多個整數, 將每個整數轉換成對應的UTF-8 位元組序列 ,並回傳這些序列連接到一起的字串。 '
663669utf8.charpattern =
664- ' 用於精確匹配到一個UTF-8 字元序列的模式,它假定處理的對象是一個合法的UTF -8 字串。 '
670+ ' 用於精確匹配到一個UTF-8 位元組序列的模式,它假定處理的對像是一個合法的UTF -8 字串。 '
665671utf8 .codes =
666672[[
667673回傳一系列的值,可以讓
@@ -670,11 +676,11 @@ for p, c in utf8.codes(s) do
670676 body
671677end
672678```
673- 疊代出字串s 中所有的字元。這裡的p 是位置(按字元數 )而c 是每個字元的編號。如果處理到一個不合法的字元序列 ,將拋出一個錯誤。
679+ 疊代出字串s 中所有的字元。這裡的p 是位置(按位元組數 )而c 是每個字元的編號。如果處理到一個不合法的位元組序列 ,將拋出一個錯誤。
674680]]
675681utf8 .codepoint =
676682' 以整數形式回傳`s` 中從位置`i` 到`j` 間(包括兩端) 所有字元的編號。 '
677683utf8 .len =
678684' 回傳字串`s` 中從位置`i` 到`j` 間(包括兩端) UTF-8 字元的個數。 '
679685utf8 .offset =
680- ' 回傳編碼在`s` 中的第`n` 個字元的開始位置(按字元數 ) (從位置`i` 處開始統計)。 '
686+ ' 回傳編碼在`s` 中的第`n` 個字元的開始位置(按位元組數 ) (從位置`i` 處開始統計)。 '
0 commit comments