44' 獨立版Lua的啟動引數。'
55
66assert =
7- ' 如果其引數 `v` 的值為假( `nil` 或 `false` ),它就呼叫 $error ;否則,回傳所有的引數。在錯誤情況時 , `message` 指那個錯誤對象 ;如果不提供這個引數,預設為 `"assertion failed!"` 。'
7+ ' 如果其引數 `v` 的值為假( `nil` 或 `false` ),它就擲回 $error ;否則,回傳所有的引數。在發生錯誤時 , `message` 是錯誤物件 ;如果不提供這個引數,預設為 `"assertion failed!"` 。'
88
99cgopt .collect =
1010' 做一次完整的垃圾回收循環。'
@@ -28,14 +28,14 @@ cgopt.isrunning =
2828' 回傳表示回收器是否在工作的布林值。'
2929
3030collectgarbage =
31- ' 這個函式是垃圾回收器的一般介面。透過引數 opt 它提供了一組不同的功能 。'
31+ ' 這個函式是垃圾回收器的一般介面。它透過引數 opt 提供了一組不同的功能 。'
3232
3333dofile =
3434' 打開該名字的檔案,並執行檔案中的 Lua 程式碼區塊。不帶引數呼叫時, `dofile` 執行標準輸入的內容(`stdin`)。回傳該程式碼區塊的所有回傳值。對於有錯誤的情況, `dofile` 將錯誤回饋給呼叫者(即 `dofile` 沒有執行在保護模式下)。'
3535
3636error =
3737[[
38- 中止上一次保護函式呼叫,將錯誤對象 `message` 回傳。函式 `error` 永遠不會回傳。
38+ 中止上一次保護函式呼叫,將錯誤物件 `message` 回傳。函式 `error` 永遠不會回傳。
3939
4040當 `message` 是一個字串時,通常 `error` 會把一些有關出錯位置的資訊附加在訊息的開頭。 `level` 引數指明了怎樣獲得出錯位置。
4141]]
@@ -47,7 +47,7 @@ getfenv =
4747' 回傳給定函式的環境。 `f` 可以是一個Lua函式,也可是一個表示呼叫堆疊層級的數字。'
4848
4949getmetatable =
50- ' 如果 `object` 不包含中繼資料表,回傳 `nil` 。否則,如果在該物件的中繼資料表中有 `"__metatable"` 域時回傳其關聯值 ,沒有時回傳該對象的中繼資料表。'
50+ ' 如果 `object` 不包含中繼資料表,回傳 `nil` 。否則,如果在該物件的中繼資料表中有 `"__metatable"` 欄位時回傳其關聯值 ,沒有時回傳該對象的中繼資料表。'
5151
5252ipairs =
5353[[
@@ -75,7 +75,7 @@ load['>5.2'] =
7575]]
7676
7777loadfile =
78- ' 從檔案 `filename` 或標準輸入(如果檔名未提供 )中獲取程式碼區塊。'
78+ ' 從檔案 `filename` 或標準輸入(如果未提供檔名 )中獲取程式碼區塊。'
7979
8080loadstring =
8181' 使用給定字串載入程式碼區塊。'
@@ -134,20 +134,24 @@ setfenv =
134134
135135setmetatable =
136136[[
137- 為指定的表設定中繼資料表。(你不能在 Lua 中改變其它類型值的中繼資料表,那些只能在 C 裡做。)如果 `metatable` 是 `nil`,將指定的表的中繼資料表移除。如果原來那張中繼資料表有 `"__metatable"` 域,擲回一個錯誤。
137+ 為指定的表設定中繼資料表,如果 `metatable` 是 `nil`,則移除該表的中繼資料表。如果原來那張中繼資料表有 `"__metatable"` 欄位,則擲回一個錯誤。
138+
139+ 這個函式回傳 `table`。
140+
141+ 你必須使用除錯庫(參見§6.10)才能修改 Lua 中其他類型的中繼資料表。
138142]]
139143
140144tonumber =
141145[[
142- 如果呼叫的時候沒有 `base` , `tonumber` 嘗試把引數轉換為一個數字 。如果引數已經是一個數字,或是一個可以轉換為數字的字串, `tonumber` 就回傳這個數字,否則回傳 `fail`。
146+ 如果呼叫的時候沒有 `base` , `tonumber` 會嘗試把引數轉換為一個數字 。如果引數已經是一個數字,或是一個可以轉換為數字的字串, `tonumber` 就回傳這個數字,否則回傳 `fail`。
143147
144148字串的轉換結果可能是整數也可能是浮點數,這取決於 Lua 的轉換文法(參見 §3.1)。(字串可以有前置和後置的空格,可以帶符號。)
145149]]
146150
147151tostring =
148152[[
149- 可以接收任何類型,它將其轉換為人可閱讀的字串形式 。浮點數總被轉換為浮點數的表現形式(小數點形式或是指數形式)。
150- 如果 `v` 有 `"__tostring"` 域的中繼資料表 , `tostring` 會以 `v` 為引數呼叫它。並用它的結果作為回傳值。
153+ 可以將任何類型轉換為人可閱讀的字串形式 。浮點數總被轉換為浮點數的表現形式(小數點形式或是指數形式)。
154+ 如果 `v` 的中繼資料表有 `"__tostring"` 欄位 , `tostring` 會以 `v` 為引數呼叫它。並用它的結果作為回傳值。
151155如果想完全控制數字如何被轉換,可以使用 $string.format 。
152156]]
153157
@@ -285,7 +289,7 @@ debug.setcstacklimit =
285289
286290設定新的C堆疊限制。該限制控制Lua中巢狀呼叫的深度,以避免堆疊溢出。
287291
288- 如果設定成功,該函式回傳之前的限制;否則回傳`false`。
292+ 如果設定成功,該函式回傳之前的限制;否則回傳 `false`。
289293]]
290294debug .setfenv =
291295' 將 `table` 設定為 `object` 的環境。'
@@ -375,7 +379,7 @@ seekwhence['.end'] =
375379' 基點為檔案尾。'
376380
377381vbuf .no =
378- ' 不緩衝;輸出操作立刻生效 。'
382+ ' 不緩衝;輸出操作即時生效 。'
379383vbuf .full =
380384' 完全緩衝;只有在快取滿或呼叫 flush 時才做輸出操作。'
381385vbuf .line =
@@ -445,9 +449,9 @@ openmode['.a+b'] =
445449' 追加更新模式,所有之前的資料都保留,只允許在檔案尾部做寫入。(二進制方式)'
446450
447451popenmode .r =
448- ' 從這個程式中讀取資料 。(二進制方式)'
452+ ' 從這個程式讀取資料 。(二進制方式)'
449453popenmode .w =
450- ' 向這個程式寫入輸入 。(二進制方式)'
454+ ' 向這個程式寫入資料 。(二進制方式)'
451455
452456filetype .file =
453457' 是一個打開的檔案控制代碼。'
@@ -493,7 +497,7 @@ math.ldexp =
493497math.log [' <5.1' ] =
494498' 回傳 `x` 的自然對數。'
495499math.log [' >5.2' ] =
496- ' 回以指定底的 `x` 的對數。'
500+ ' 回傳指定底的 `x` 的對數。'
497501math .log10 =
498502' 回傳 `x` 的以10為底的對數。'
499503math .max =
@@ -541,7 +545,7 @@ math.tointeger['>5.3'] =
541545math.type [' >5.3' ] =
542546' 如果 `x` 是整數,回傳 `"integer"` ,如果它是浮點數,回傳 `"float"` ,如果 `x` 不是數字,回傳 `nil` 。'
543547math .ult [' >5.3' ] =
544- ' 整數 `m` 和 `n` 以無符號整數形式比較,如果 `m` 在 `n` 之下則回傳布林真 ,否則回傳假。'
548+ ' 整數 `m` 和 `n` 以無符號整數形式比較,如果 `m` 小於 `n` 則回傳布林真 ,否則回傳假。'
545549
546550os =
547551' '
@@ -562,7 +566,7 @@ os.getenv =
562566os .remove =
563567' 刪除指定名字的檔案。'
564568os .rename =
565- ' 將名字為 `oldname` 的檔案或目錄更名為 `newname`。'
569+ ' 將名字為 `oldname` 的檔案或資料夾重新命名為 `newname`。'
566570os .setlocale =
567571' 設定程式的目前區域。'
568572os .time =
@@ -595,7 +599,7 @@ package =
595599require [' <5.3' ] =
596600' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )。'
597601require [' >5.4' ] =
598- ' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )與搜尋器回傳的載入資料。預設搜尋器的載入資料指示了載入位置,對於檔案來説就是檔案路徑 。'
602+ ' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )與搜尋器回傳的載入資料。預設搜尋器的載入資料指示了載入位置,對於檔案來說就是檔案路徑 。'
599603
600604package.config =
601605' 一個描述一些為包管理準備的編譯時期組態的字串。'
@@ -623,7 +627,7 @@ string =
623627string .byte =
624628' 回傳字元 `s[i]` 、 `s[i+1]` ... `s[j]` 的內部數字編碼。'
625629string .char =
626- ' 接收零或更多的整數, 回傳和引數數量相同長度的字串。其中每個字元的內部編碼值等於對應的引數值。'
630+ ' 回傳和引數數量相同長度的字串。其中每個字元的內部編碼值等於對應的引數值。'
627631string .dump =
628632' 回傳包含有以二進制方式表示的(一個 *二進制程式碼區塊* )指定函式的字串。'
629633string .find =
@@ -632,7 +636,7 @@ string.format =
632636' 回傳不定數量引數的格式化版本,格式化字串為第一個引數。'
633637string .gmatch =
634638[[
635- 回傳一個疊代器函式。每次呼叫這個函式都會繼續以 `pattern` (參見 §6.4.1)對 s 做配對,並回傳所有捕獲到的值。
639+ 回傳一個疊代器函式。每次呼叫這個函式都會繼續以 `pattern` (參見 §6.4.1)對 s 做配對,並回傳所有捕獲到的值。
636640
637641下面這個例子會循環疊代字串 s 中所有的單詞, 並逐行列印:
638642```lua
@@ -644,7 +648,7 @@ string.gmatch =
644648```
645649]]
646650string .gsub =
647- ' 將字串 s 中,所有的(或是在 n 給出時的前 n 個) `pattern` (參見 §6.4.1)都替換成 `repl` ,並回傳其副本。'
651+ ' 將字串 s 中,所有的(或是有提供 n 時的前 n 個) `pattern` (參見 §6.4.1)都替換成 `repl` ,並回傳其副本。'
648652string .len =
649653' 回傳其長度。'
650654string .lower =
@@ -656,11 +660,11 @@ string.pack =
656660string .packsize =
657661[[ 回傳以指定格式用 $string.pack 壓縮的字串的長度。格式化字串中不可以有變長選項 's' 或 'z' (參見 §6.4.2)。]]
658662string.rep [' >5.2' ] =
659- ' 回傳 `n` 個字串 `s` 以字串 `sep` 為分割符連在一起的字串。預設的 `sep` 值為空字串(即沒有分割符)。如果 `n` 不是正數則回傳空字串。'
663+ ' 回傳 `n` 個由字串 `s` 以字串 `sep` 為分割符連在一起的字串。預設的 `sep` 值為空字串(即沒有分割符)。如果 `n` 不是正數則回傳空字串。'
660664string.rep [' <5.1' ] =
661- ' 回傳 `n` 個字串 `s` 連在一起的字串。如果 `n` 不是正數則回傳空字串。'
665+ ' 回傳 `n` 個由字串 `s` 連在一起的字串。如果 `n` 不是正數則回傳空字串。'
662666string .reverse =
663- ' 回傳字串 s 的反轉字串。'
667+ ' 回傳字串 `s` 的反轉字串。'
664668string .sub =
665669' 回傳一個從 `i` 開始並在 `j` 結束的子字串。'
666670string .unpack =
@@ -700,9 +704,9 @@ table.unpack =
700704i 預設為 1 , j 預設為 #list。
701705]]
702706table .foreach =
703- ' 走訪表中的每一個元素,並以key和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止 ,並且回傳這個值。該函式等同pair(list),比pair(list)更慢。 不推薦使用。'
707+ ' 走訪表中的每一個元素,並以key和value執行回呼函式。如果回呼函式回傳一個非nil值則終止迴圈 ,並且回傳這個值。該函式等同pair(list),比pair(list)更慢, 不推薦使用。'
704708table .foreachi =
705- ' 走訪表中的每一個元素,並以索引號index和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止 ,並且回傳這個值。該函式等同ipair(list),比ipair(list)更慢。 不推薦使用。'
709+ ' 走訪表中的每一個元素,並以索引號index和value執行回呼函式。如果回呼函式回傳一個非nil值則終止迴圈 ,並且回傳這個值。該函式等同ipair(list),比ipair(list)更慢, 不推薦使用。'
706710table .getn =
707711' 回傳表的長度。該函式等價於#list。'
708712table .new =
0 commit comments