4
4
' 獨立版Lua的啟動引數。'
5
5
6
6
assert =
7
- ' 如果其引數 `v` 的值為假( `nil` 或 `false` ),它就呼叫 $error ;否則,回傳所有的引數。在錯誤情況時 , `message` 指那個錯誤對象 ;如果不提供這個引數,預設為 `"assertion failed!"` 。'
7
+ ' 如果其引數 `v` 的值為假( `nil` 或 `false` ),它就擲回 $error ;否則,回傳所有的引數。在發生錯誤時 , `message` 是錯誤物件 ;如果不提供這個引數,預設為 `"assertion failed!"` 。'
8
8
9
9
cgopt .collect =
10
10
' 做一次完整的垃圾回收循環。'
@@ -28,14 +28,14 @@ cgopt.isrunning =
28
28
' 回傳表示回收器是否在工作的布林值。'
29
29
30
30
collectgarbage =
31
- ' 這個函式是垃圾回收器的一般介面。透過引數 opt 它提供了一組不同的功能 。'
31
+ ' 這個函式是垃圾回收器的一般介面。它透過引數 opt 提供了一組不同的功能 。'
32
32
33
33
dofile =
34
34
' 打開該名字的檔案,並執行檔案中的 Lua 程式碼區塊。不帶引數呼叫時, `dofile` 執行標準輸入的內容(`stdin`)。回傳該程式碼區塊的所有回傳值。對於有錯誤的情況, `dofile` 將錯誤回饋給呼叫者(即 `dofile` 沒有執行在保護模式下)。'
35
35
36
36
error =
37
37
[[
38
- 中止上一次保護函式呼叫,將錯誤對象 `message` 回傳。函式 `error` 永遠不會回傳。
38
+ 中止上一次保護函式呼叫,將錯誤物件 `message` 回傳。函式 `error` 永遠不會回傳。
39
39
40
40
當 `message` 是一個字串時,通常 `error` 會把一些有關出錯位置的資訊附加在訊息的開頭。 `level` 引數指明了怎樣獲得出錯位置。
41
41
]]
@@ -47,7 +47,7 @@ getfenv =
47
47
' 回傳給定函式的環境。 `f` 可以是一個Lua函式,也可是一個表示呼叫堆疊層級的數字。'
48
48
49
49
getmetatable =
50
- ' 如果 `object` 不包含中繼資料表,回傳 `nil` 。否則,如果在該物件的中繼資料表中有 `"__metatable"` 域時回傳其關聯值 ,沒有時回傳該對象的中繼資料表。'
50
+ ' 如果 `object` 不包含中繼資料表,回傳 `nil` 。否則,如果在該物件的中繼資料表中有 `"__metatable"` 欄位時回傳其關聯值 ,沒有時回傳該對象的中繼資料表。'
51
51
52
52
ipairs =
53
53
[[
@@ -75,7 +75,7 @@ load['>5.2'] =
75
75
]]
76
76
77
77
loadfile =
78
- ' 從檔案 `filename` 或標準輸入(如果檔名未提供 )中獲取程式碼區塊。'
78
+ ' 從檔案 `filename` 或標準輸入(如果未提供檔名 )中獲取程式碼區塊。'
79
79
80
80
loadstring =
81
81
' 使用給定字串載入程式碼區塊。'
@@ -134,20 +134,24 @@ setfenv =
134
134
135
135
setmetatable =
136
136
[[
137
- 為指定的表設定中繼資料表。(你不能在 Lua 中改變其它類型值的中繼資料表,那些只能在 C 裡做。)如果 `metatable` 是 `nil`,將指定的表的中繼資料表移除。如果原來那張中繼資料表有 `"__metatable"` 域,擲回一個錯誤。
137
+ 為指定的表設定中繼資料表,如果 `metatable` 是 `nil`,則移除該表的中繼資料表。如果原來那張中繼資料表有 `"__metatable"` 欄位,則擲回一個錯誤。
138
+
139
+ 這個函式回傳 `table`。
140
+
141
+ 你必須使用除錯庫(參見§6.10)才能修改 Lua 中其他類型的中繼資料表。
138
142
]]
139
143
140
144
tonumber =
141
145
[[
142
- 如果呼叫的時候沒有 `base` , `tonumber` 嘗試把引數轉換為一個數字 。如果引數已經是一個數字,或是一個可以轉換為數字的字串, `tonumber` 就回傳這個數字,否則回傳 `fail`。
146
+ 如果呼叫的時候沒有 `base` , `tonumber` 會嘗試把引數轉換為一個數字 。如果引數已經是一個數字,或是一個可以轉換為數字的字串, `tonumber` 就回傳這個數字,否則回傳 `fail`。
143
147
144
148
字串的轉換結果可能是整數也可能是浮點數,這取決於 Lua 的轉換文法(參見 §3.1)。(字串可以有前置和後置的空格,可以帶符號。)
145
149
]]
146
150
147
151
tostring =
148
152
[[
149
- 可以接收任何類型,它將其轉換為人可閱讀的字串形式 。浮點數總被轉換為浮點數的表現形式(小數點形式或是指數形式)。
150
- 如果 `v` 有 `"__tostring"` 域的中繼資料表 , `tostring` 會以 `v` 為引數呼叫它。並用它的結果作為回傳值。
153
+ 可以將任何類型轉換為人可閱讀的字串形式 。浮點數總被轉換為浮點數的表現形式(小數點形式或是指數形式)。
154
+ 如果 `v` 的中繼資料表有 `"__tostring"` 欄位 , `tostring` 會以 `v` 為引數呼叫它。並用它的結果作為回傳值。
151
155
如果想完全控制數字如何被轉換,可以使用 $string.format 。
152
156
]]
153
157
@@ -285,7 +289,7 @@ debug.setcstacklimit =
285
289
286
290
設定新的C堆疊限制。該限制控制Lua中巢狀呼叫的深度,以避免堆疊溢出。
287
291
288
- 如果設定成功,該函式回傳之前的限制;否則回傳`false`。
292
+ 如果設定成功,該函式回傳之前的限制;否則回傳 `false`。
289
293
]]
290
294
debug .setfenv =
291
295
' 將 `table` 設定為 `object` 的環境。'
@@ -375,7 +379,7 @@ seekwhence['.end'] =
375
379
' 基點為檔案尾。'
376
380
377
381
vbuf .no =
378
- ' 不緩衝;輸出操作立刻生效 。'
382
+ ' 不緩衝;輸出操作即時生效 。'
379
383
vbuf .full =
380
384
' 完全緩衝;只有在快取滿或呼叫 flush 時才做輸出操作。'
381
385
vbuf .line =
@@ -445,9 +449,9 @@ openmode['.a+b'] =
445
449
' 追加更新模式,所有之前的資料都保留,只允許在檔案尾部做寫入。(二進制方式)'
446
450
447
451
popenmode .r =
448
- ' 從這個程式中讀取資料 。(二進制方式)'
452
+ ' 從這個程式讀取資料 。(二進制方式)'
449
453
popenmode .w =
450
- ' 向這個程式寫入輸入 。(二進制方式)'
454
+ ' 向這個程式寫入資料 。(二進制方式)'
451
455
452
456
filetype .file =
453
457
' 是一個打開的檔案控制代碼。'
@@ -493,7 +497,7 @@ math.ldexp =
493
497
math.log [' <5.1' ] =
494
498
' 回傳 `x` 的自然對數。'
495
499
math.log [' >5.2' ] =
496
- ' 回以指定底的 `x` 的對數。'
500
+ ' 回傳指定底的 `x` 的對數。'
497
501
math .log10 =
498
502
' 回傳 `x` 的以10為底的對數。'
499
503
math .max =
@@ -541,7 +545,7 @@ math.tointeger['>5.3'] =
541
545
math.type [' >5.3' ] =
542
546
' 如果 `x` 是整數,回傳 `"integer"` ,如果它是浮點數,回傳 `"float"` ,如果 `x` 不是數字,回傳 `nil` 。'
543
547
math .ult [' >5.3' ] =
544
- ' 整數 `m` 和 `n` 以無符號整數形式比較,如果 `m` 在 `n` 之下則回傳布林真 ,否則回傳假。'
548
+ ' 整數 `m` 和 `n` 以無符號整數形式比較,如果 `m` 小於 `n` 則回傳布林真 ,否則回傳假。'
545
549
546
550
os =
547
551
' '
@@ -562,7 +566,7 @@ os.getenv =
562
566
os .remove =
563
567
' 刪除指定名字的檔案。'
564
568
os .rename =
565
- ' 將名字為 `oldname` 的檔案或目錄更名為 `newname`。'
569
+ ' 將名字為 `oldname` 的檔案或資料夾重新命名為 `newname`。'
566
570
os .setlocale =
567
571
' 設定程式的目前區域。'
568
572
os .time =
@@ -595,7 +599,7 @@ package =
595
599
require [' <5.3' ] =
596
600
' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )。'
597
601
require [' >5.4' ] =
598
- ' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )與搜尋器回傳的載入資料。預設搜尋器的載入資料指示了載入位置,對於檔案來説就是檔案路徑 。'
602
+ ' 載入一個模組,回傳該模組的回傳值( `nil` 時為 `true` )與搜尋器回傳的載入資料。預設搜尋器的載入資料指示了載入位置,對於檔案來說就是檔案路徑 。'
599
603
600
604
package.config =
601
605
' 一個描述一些為包管理準備的編譯時期組態的字串。'
@@ -623,7 +627,7 @@ string =
623
627
string .byte =
624
628
' 回傳字元 `s[i]` 、 `s[i+1]` ... `s[j]` 的內部數字編碼。'
625
629
string .char =
626
- ' 接收零或更多的整數, 回傳和引數數量相同長度的字串。其中每個字元的內部編碼值等於對應的引數值。'
630
+ ' 回傳和引數數量相同長度的字串。其中每個字元的內部編碼值等於對應的引數值。'
627
631
string .dump =
628
632
' 回傳包含有以二進制方式表示的(一個 *二進制程式碼區塊* )指定函式的字串。'
629
633
string .find =
@@ -632,7 +636,7 @@ string.format =
632
636
' 回傳不定數量引數的格式化版本,格式化字串為第一個引數。'
633
637
string .gmatch =
634
638
[[
635
- 回傳一個疊代器函式。每次呼叫這個函式都會繼續以 `pattern` (參見 §6.4.1)對 s 做配對,並回傳所有捕獲到的值。
639
+ 回傳一個疊代器函式。每次呼叫這個函式都會繼續以 `pattern` (參見 §6.4.1)對 s 做配對,並回傳所有捕獲到的值。
636
640
637
641
下面這個例子會循環疊代字串 s 中所有的單詞, 並逐行列印:
638
642
```lua
@@ -644,7 +648,7 @@ string.gmatch =
644
648
```
645
649
]]
646
650
string .gsub =
647
- ' 將字串 s 中,所有的(或是在 n 給出時的前 n 個) `pattern` (參見 §6.4.1)都替換成 `repl` ,並回傳其副本。'
651
+ ' 將字串 s 中,所有的(或是有提供 n 時的前 n 個) `pattern` (參見 §6.4.1)都替換成 `repl` ,並回傳其副本。'
648
652
string .len =
649
653
' 回傳其長度。'
650
654
string .lower =
@@ -656,11 +660,11 @@ string.pack =
656
660
string .packsize =
657
661
[[ 回傳以指定格式用 $string.pack 壓縮的字串的長度。格式化字串中不可以有變長選項 's' 或 'z' (參見 §6.4.2)。]]
658
662
string.rep [' >5.2' ] =
659
- ' 回傳 `n` 個字串 `s` 以字串 `sep` 為分割符連在一起的字串。預設的 `sep` 值為空字串(即沒有分割符)。如果 `n` 不是正數則回傳空字串。'
663
+ ' 回傳 `n` 個由字串 `s` 以字串 `sep` 為分割符連在一起的字串。預設的 `sep` 值為空字串(即沒有分割符)。如果 `n` 不是正數則回傳空字串。'
660
664
string.rep [' <5.1' ] =
661
- ' 回傳 `n` 個字串 `s` 連在一起的字串。如果 `n` 不是正數則回傳空字串。'
665
+ ' 回傳 `n` 個由字串 `s` 連在一起的字串。如果 `n` 不是正數則回傳空字串。'
662
666
string .reverse =
663
- ' 回傳字串 s 的反轉字串。'
667
+ ' 回傳字串 `s` 的反轉字串。'
664
668
string .sub =
665
669
' 回傳一個從 `i` 開始並在 `j` 結束的子字串。'
666
670
string .unpack =
@@ -700,9 +704,9 @@ table.unpack =
700
704
i 預設為 1 , j 預設為 #list。
701
705
]]
702
706
table .foreach =
703
- ' 走訪表中的每一個元素,並以key和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止 ,並且回傳這個值。該函式等同pair(list),比pair(list)更慢。 不推薦使用。'
707
+ ' 走訪表中的每一個元素,並以key和value執行回呼函式。如果回呼函式回傳一個非nil值則終止迴圈 ,並且回傳這個值。該函式等同pair(list),比pair(list)更慢, 不推薦使用。'
704
708
table .foreachi =
705
- ' 走訪表中的每一個元素,並以索引號index和value執行回呼函式。如果回呼函式回傳一個非nil值則循環終止 ,並且回傳這個值。該函式等同ipair(list),比ipair(list)更慢。 不推薦使用。'
709
+ ' 走訪表中的每一個元素,並以索引號index和value執行回呼函式。如果回呼函式回傳一個非nil值則終止迴圈 ,並且回傳這個值。該函式等同ipair(list),比ipair(list)更慢, 不推薦使用。'
706
710
table .getn =
707
711
' 回傳表的長度。該函式等價於#list。'
708
712
table .new =
0 commit comments