1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
|
---@diagnostic disable: undefined-global, lowercase-global
-- basic
arg =
'獨立版Lua的啟動參數。 '
assert =
'如果其參數`v` 的值為假(`nil` 或`false`), 它就呼叫$error; 否則,回傳所有的參數。在錯誤情況時, `message` 指那個錯誤對象; 如果不提供這個參數,參數預設為`"assertion failed!"` 。 '
cgopt.collect =
'做一次完整的垃圾回收循環。 '
cgopt.stop =
'停止垃圾回收的執行。 '
cgopt.restart =
'重啟垃圾回收的自動執行。 '
cgopt.count =
'以K 字元數為單位回傳Lua 使用的總記憶體量。 '
cgopt.step =
'單步執行垃圾回收。步長“大小”由`arg` 控制。 '
cgopt.setpause =
'將`arg` 設為垃圾回收的*間歇率* 。 '
cgopt.setstepmul =
'將`arg` 設為垃圾回收的*步進倍率* 。 '
cgopt.incremental =
'改變垃圾回收模式為增量模式。 '
cgopt.generational =
'改變垃圾回收模式為分代模式。 '
cgopt.isrunning =
'回傳表示垃圾回收是否在工作的布林值。 '
collectgarbage =
'這個函式是垃圾回收的通用介面。通過參數opt 它提供了一組不同的功能。 '
dofile =
'打開該名字的檔案,並執行檔案中的Lua 程式碼區塊。不帶參數呼叫時, `dofile` 執行標準輸入的內容(`stdin`)。回傳該程式碼區塊的所有回傳值。對於有錯誤的情況,`dofile` 將錯誤反饋給呼叫者(即,`dofile` 沒有在保護模式下執行)。 '
error =
[[
中止上一次保護函式呼叫, 將錯誤對象`message` 回傳。函式`error` 永遠不會回傳。
當`message` 是一個字串時,通常`error` 會把一些有關出錯位置的訊息附加在訊息的前頭。 level 參數指明了怎樣獲得出錯位置。
]]
_G =
'一個全域變數(非函式), 內部儲存有全域環境(參見§2.2)。 Lua 自己不使用這個變數; 改變這個變數的值不會對任何環境造成影響,反之亦然。 '
getfenv =
'回傳給定函式的環境。 `f` 可以是一個Lua函式,也可是一個表示呼叫堆疊層級的數字。 '
getmetatable =
'如果`object` 不包含元表,回傳`nil` 。否則,如果在該對象的元表中有`"__metatable"` 域時回傳其關聯值, 沒有時回傳該對象的元表。 '
ipairs =
[[
回傳三個值(疊代函式、表`t` 以及`0` ), 如此,以下程式碼
```lua
for i,v in ipairs(t) do body end
```
將疊代鍵值對`(1,t[1]) ,(2,t[2]), ...` ,直到第一個空值。
]]
loadmode.b =
'只能是二進制程式碼區塊。 '
loadmode.t =
'只能是文字程式碼區塊。 '
loadmode.bt =
'可以是二進制也可以是文字。 '
load['<5.1'] =
'使用`func` 分段載入程式碼區塊。每次呼叫`func` 必須回傳一個字串用於連接前文。 '
load['>5.2'] =
[[
載入一個程式碼區塊。
如果`chunk` 是一個字串,程式碼區塊指這個字串。如果`chunk` 是一個函式, `load` 不斷地呼叫它獲取程式碼區塊的片段。每次對`chunk` 的呼叫都必須回傳一個字串緊緊連接在上次呼叫的回傳之後。當回傳空字串、`nil`、或是不回傳值時,都表示程式碼區塊結束。
]]
loadfile =
'從檔案`filename` 或標準輸入(如果檔名未提供)中獲取程式碼區塊。 '
loadstring =
'使用給定字串載入程式碼區塊。 '
module =
'創建一個模組。 '
next =
[[
執行程式來走訪表中的所有域。第一個參數是要走訪的表,第二個參數是表中的某個鍵。 `next` 回傳該鍵的下一個鍵及其關聯的值。如果用`nil` 作為第二個參數呼叫`next` 將回傳初始鍵及其關聯值。當以最後一個鍵去呼叫,或是以`nil` 呼叫一張空表時, `next` 回傳`nil`。如果不提供第二個參數,將認為它就是`nil`。特別指出,你可以用`next(t)` 來判斷一張表是否是空的。
索引在走訪過程中的次序無定義, 即使是數字索引也是這樣。 (如果想按數字次序走訪表,可以使用數字形式的`for` 。)
當在走訪過程中你給表中並不存在的域賦值, `next` 的行為是未定義的。然而你可以去修改那些已存在的域。特別指出,你可以清除一些已存在的域。
]]
pairs =
[[
如果`t` 有元方法`__pairs`, 以`t` 為參數呼叫它,並回傳其回傳的前三個值。
否則,回傳三個值:`next` 函式, 表`t`,以及`nil`。因此以下程式碼
```lua
for k,v in pairs(t) do body end
```
能疊代表`t` 中的所有鍵值對。
參見函式$next 中關於疊代過程中修改表的風險。
]]
pcall =
'傳入參數,以*保護模式* 呼叫函式`f` 。這意味著`f` 中的任何錯誤不會拋出; 取而代之的是,`pcall` 會將錯誤捕獲到,並回傳一個狀態碼。第一個回傳值是狀態碼(一個布林值), 當沒有錯誤時,其為真。此時,`pcall` 同樣會在狀態碼後回傳所有呼叫的結果。在有錯誤時,`pcall` 回傳`false` 加錯誤訊息。 '
print =
'接收任意數量的參數,並將它們的值列印到`stdout`。它用`tostring` 函式將每個參數都轉換為字串。 `print` 不用於做格式化輸出。僅作為看一下某個值的快捷方式。多用於除錯。完整的對輸出的控制,請使用$string.format 以及$io.write。 '
rawequal =
'在不觸發任何元方法的情況下檢查`v1` 是否和`v2` 相等。回傳一個布林值。 '
rawget =
'在不觸發任何元方法的情況下獲取`table[index]` 的值。 `table` 必須是一張表; `index` 可以是任何值。 '
rawlen =
'在不觸發任何元方法的情況下回傳對象`v` 的長度。 `v` 可以是表或字串。它回傳一個整數。 '
rawset =
[[
在不觸發任何元方法的情況下將`table[index]` 設為`value。 ` `table` 必須是一張表, `index` 可以是`nil` 與`NaN` 之外的任何值。 `value` 可以是任何Lua 值。
這個函式回傳`table`。
]]
select =
'如果`index` 是個數字, 那麼回傳參數中第`index` 個之後的部分; 負的數字會從後向前索引(`-1` 指最後一個參數)。否則,`index` 必須是字串`"#"`, 此時`select` 回傳參數的個數。 '
setfenv =
'設定給定函式的環境。 '
setmetatable =
[[
給指定表設定元表。 (你不能在Lua 中改變其它類型值的元表,那些只能在C 裡做。) 如果`metatable` 是`nil`, 將指定表的元表移除。如果原來那張元表有`"__metatable"` 域,拋出一個錯誤。
]]
tonumber =
[[
如果呼叫的時候沒有`base`, `tonumber` 嘗試把參數轉換為一個數字。如果參數已經是一個數字,或是一個可以轉換為數字的字串, `tonumber` 就回傳這個數字; 否則回傳`nil`。
字串的轉換結果可能是整數也可能是浮點數, 這取決於Lua 的轉換文法(參見§3.1)。 (字串可以有前置和後置的空格,可以帶符號。)
]]
tostring =
[[
可以接收任何類型,它將其轉換為人可閱讀的字串形式。浮點數總被轉換為浮點數的表現形式(小數點形式或是指數形式)。 (如果想完全控制數字如何被轉換,可以使用$string.format。)
如果`v` 有`"__tostring"` 域的元表, `tostring` 會以`v` 為參數呼叫它。並用它的結果作為回傳值。
]]
type =
[[
將參數的類型編碼為一個字串回傳。函式可能的回傳值有`"nil"` (一個字串,而不是`nil` 值), `"number"`, `"string"`, `"boolean"`, `"table"`, `"function"`, `"thread"`, `"userdata"`。
]]
_VERSION =
'一個包含有目前直譯器版本號的全域變數(並非函式)。 '
warn =
'使用所有參數組成的字串消息來發送警告。 '
xpcall['=5.1'] =
'傳入參數,以*保護模式* 呼叫函式`f` 。這個函式和`pcall` 類似。不過它可以額外設定一個訊息處理器`err`。 '
xpcall['>5.2'] =
'傳入參數,以*保護模式* 呼叫函式`f` 。這個函式和`pcall` 類似。不過它可以額外設定一個訊息處理器`msgh`。 '
unpack =
[[
回傳給定`list` 中的所有元素。該函式等價於
```lua
return list[i], list[i+1], ···, list[j]
```
]]
bit32 =
''
bit32.arshift =
[[
回傳`x` 向右位移`disp` 位的結果。 `disp` 為負時向左位移。這是算數位移操作,左側的空位使用`x` 的高位填充,右側空位使用`0` 填充。
]]
bit32.band =
'回傳參數按位與的結果。 '
bit32.bnot =
[[
回傳`x` 按位取反的結果。
```lua
assert(bit32.bnot(x) ==
(-1 - x) % 2^32)
```
]]
bit32.bor =
'回傳參數按位或的結果。 '
bit32.btest =
'參數按位與的結果不為0時,回傳`true` 。 '
bit32.bxor =
'回傳參數按位互斥或的結果。 '
bit32.extract =
'回傳`n` 中第`field` 到第`field + width - 1` 位組成的結果。 '
bit32.replace =
'回傳`v` 的第`field` 到第`field + width - 1` 位替換`n` 的對應位後的結果。 '
bit32.lrotate =
'回傳`x` 向左旋轉`disp` 位的結果。 `disp` 為負時向右旋轉。 '
bit32.lshift =
[[
回傳`x` 向左位移`disp` 位的結果。 `disp` 為負時向右位移。空位總是使用`0` 填充。
```lua
assert(bit32.lshift(b, disp) ==
(b * 2^disp) % 2^32)
```
]]
bit32.rrotate =
'回傳`x` 向右旋轉`disp` 位的結果。 `disp` 為負時向左旋轉。 '
bit32.rshift =
[[
回傳`x` 向右位移`disp` 位的結果。 `disp` 為負時向左位移。空位總是使用`0` 填充。
```lua
assert(bit32.lshift(b, disp) ==
(b * 2^disp) % 2^32)
```
]]
coroutine =
''
coroutine.create =
'創建一個主體函式為`f` 的新共常式。 f 必須是一個Lua 的函式。回傳這個新共常式,它是一個類型為`"thread"` 的對象。 '
coroutine.isyieldable =
'如果正在執行的共常式可以讓出,則回傳真。 '
coroutine.isyieldable['>5.4'] =
'如果共常式`co` 可以讓出,則回傳真。 `co` 預設為正在執行的共常式。 '
coroutine.close =
'關閉共常式`co`,並關閉它所有等待*to-be-closed* 的變數,並將共常式狀態設為`dead` 。 '
coroutine.resume =
'開始或繼續共常式`co` 的執行。 '
coroutine.running =
'回傳目前正在執行的共常式加一個布林值。如果目前執行的共常式是主執行緒,其為真。 '
coroutine.status =
'以字串形式回傳共常式`co` 的狀態。 '
coroutine.wrap =
'創建一個主體函式為`f` 的新共常式。 f 必須是一個Lua 的函式。回傳一個函式, 每次呼叫該函式都會延續該共常式。 '
coroutine.yield =
'掛起正在呼叫的共常式的執行。 '
costatus.running =
'正在執行。 '
costatus.suspended =
'掛起或是還沒有開始執行。 '
costatus.normal =
'是活動的,但並不在執行。 '
costatus.dead =
'執行完主體函式或因錯誤停止。 '
debug =
''
debug.debug =
'進入一個使用者交互模式,執行使用者輸入的每個字串。 '
debug.getfenv =
'回傳對象`o` 的環境。 '
debug.gethook =
'回傳三個表示執行緒鉤子設定的值: 目前鉤子函式,目前鉤子掩碼,目前鉤子計數。 '
debug.getinfo =
'回傳關於一個函式訊息的表。 '
debug.getlocal['<5.1'] =
'回傳在堆疊的`level` 層處函式的索引為`index` 的區域變數的名字和值。 '
debug.getlocal['>5.2'] =
'回傳在堆疊的`f` 層處函式的索引為`index` 的區域變數的名字和值。 '
debug.getmetatable =
'回傳給定`value` 的元表。 '
debug.getregistry =
'回傳註冊表。 '
debug.getupvalue =
'回傳函式`f` 的第`up` 個上值的名字和值。 '
debug.getuservalue['<5.3']=
'回傳關聯在`u` 上的`Lua` 值。 '
debug.getuservalue['>5.4']=
'回傳關聯在`u` 上的第`n` 個`Lua` 值,以及一個布林,`false`表示值不存在。 '
debug.setcstacklimit =
[[
### **已在`Lua 5.4.2` 中廢棄**
設定新的C堆疊限制。該限制控制Lua中嵌套呼叫的深度,以避免堆疊溢出。
如果設定成功,該函式回傳之前的限制;否則回傳`false`。
]]
debug.setfenv =
'將`table` 設定為`object` 的環境。 '
debug.sethook =
'將一個函式作為鉤子函式設入。 '
debug.setlocal =
'將`value` 賦給堆疊上第`level` 層函式的第`local` 個區域變數。 '
debug.setmetatable =
'將`value` 的元表設為`table` (可以是`nil`)。 '
debug.setupvalue =
'將`value` 設為函式`f` 的第`up` 個上值。 '
debug.setuservalue['<5.3']=
'將`value` 設為`udata` 的關聯值。 '
debug.setuservalue['>5.4']=
'將`value` 設為`udata` 的第`n` 個關聯值。 '
debug.traceback =
'回傳呼叫堆疊的堆疊回溯訊息。字串可選項`message` 被添加在堆疊回溯訊息的開頭。 '
debug.upvalueid =
'回傳指定函式第`n` 個上值的唯一識別符(一個輕量使用者資料)。 '
debug.upvaluejoin =
'讓Lua 閉包`f1` 的第`n1` 個上值引用`Lua` 閉包`f2` 的第`n2` 個上值。 '
infowhat.n =
'`name` 和`namewhat`'
infowhat.S =
'`source`,`short_src`,`linedefined`,`lalinedefined`,和`what`'
infowhat.l =
'`currentline`'
infowhat.t =
'`istailcall`'
infowhat.u['<5.1'] =
'`nups`'
infowhat.u['>5.2'] =
'`nups`、`nparams` 和`isvararg`'
infowhat.f =
'`func`'
infowhat.r =
'`ftransfer` 和`ntransfer`'
infowhat.L =
'`activelines`'
hookmask.c =
'每當Lua 呼叫一個函式時,呼叫鉤子。 '
hookmask.r =
'每當Lua 從一個函式內回傳時,呼叫鉤子。 '
hookmask.l =
'每當Lua 進入新的一行時,呼叫鉤子。 '
file =
''
file[':close'] =
'關閉`file`。 '
file[':flush'] =
'將寫入的資料儲存到`file` 中。 '
file[':lines'] =
[[
------
```lua
for c in file:lines(...) do
body
end
```
]]
file[':read'] =
'讀檔案`file`, 指定的格式決定了要讀什麼。 '
file[':seek'] =
'設定及獲取基於檔案開頭處計算出的位置。 '
file[':setvbuf'] =
'設定輸出檔案的緩衝模式。 '
file[':write'] =
'將參數的值逐個寫入`file`。 '
readmode.n =
'讀取一個數字,根據Lua 的轉換文法回傳浮點數或整數。 '
readmode.a =
'從目前位置開始讀取整個檔案。 '
readmode.l =
'讀取一行並忽略行結束標記。 '
readmode.L =
'讀取一行並保留行結束標記。 '
seekwhence.set =
'基點為0 (檔案開頭)。 '
seekwhence.cur =
'基點為目前位置。 '
seekwhence['.end'] =
'基點為檔案尾。 '
vbuf.no =
'不緩衝;輸出操作立刻生效。 '
vbuf.full =
'完全緩衝;只有在緩存滿或呼叫flush 時才做輸出操作。 '
vbuf.line =
'行緩衝;輸出將緩衝到每次換行前。 '
io =
''
io.stdin =
'標準輸入。 '
io.stdout =
'標準輸出。 '
io.stderr =
'標準錯誤。 '
io.close =
'關閉`file` 或預設輸出檔案。 '
io.flush =
'將寫入的資料儲存到預設輸出檔案中。 '
io.input =
'設定`file` 為預設輸入檔案。 '
io.lines =
[[
------
```lua
for c in io.lines(filename, ...) do
body
end
```
]]
io.open =
'用字串`mode` 指定的模式打開一個檔案。 '
io.output =
'設定`file` 為預設輸出檔案。 '
io.popen =
'用一個分離行程開啟程式`prog` 。 '
io.read =
'讀檔案`file`, 指定的格式決定了要讀什麼。 '
io.tmpfile =
'如果成功,回傳一個臨時檔案的控制代碼。 '
io.type =
'檢查`obj` 是否是合法的檔案控制代碼。 '
io.write =
'將參數的值逐個寫入預設輸出檔案。 '
openmode.r =
'讀模式。 '
openmode.w =
'寫模式。 '
openmode.a =
'追加模式。 '
openmode['.r+'] =
'更新模式,所有之前的資料都保留。 '
openmode['.w+'] =
'更新模式,所有之前的資料都刪除。 '
openmode['.a+'] =
'追加更新模式,所有之前的資料都保留,只允許在檔案尾部做寫入。 '
openmode.rb =
'讀模式。 (二進制方式)'
openmode.wb =
'寫模式。 (二進制方式)'
openmode.ab =
'追加模式。 (二進制方式)'
openmode['.r+b'] =
'更新模式,所有之前的資料都保留。 (二進制方式)'
openmode['.w+b'] =
'更新模式,所有之前的資料都刪除。 (二進制方式)'
openmode['.a+b'] =
'追加更新模式,所有之前的資料都保留,只允許在檔案尾部做寫入。 (二進制方式)'
popenmode.r =
'從這個程式中讀取資料。 (二進制方式)'
popenmode.w =
'向這個程式寫入輸入。 (二進制方式)'
filetype.file =
'是一個打開的檔案控制代碼。 '
filetype['.closed file'] =
'是一個關閉的檔案控制代碼。 '
filetype['.nil'] =
'不是檔案控制代碼。 '
math =
''
math.abs =
'回傳`x` 的絕對值。 '
math.acos =
'回傳`x` 的反餘弦值(用弧度表示)。 '
math.asin =
'回傳`x` 的反正弦值(用弧度表示)。 '
math.atan['<5.2'] =
'回傳`x` 的反正切值(用弧度表示)。 '
math.atan['>5.3'] =
'回傳`y/x` 的反正切值(用弧度表示)。 '
math.atan2 =
'回傳`y/x` 的反正切值(用弧度表示)。 '
math.ceil =
'回傳不小於`x` 的最小整數值。 '
math.cos =
'回傳`x` 的餘弦(假定參數是弧度)。 '
math.cosh =
'回傳`x` 的雙曲餘弦(假定參數是弧度)。 '
math.deg =
'將角`x` 從弧度轉換為角度。 '
math.exp =
'回傳`e^x` 的值(e 為自然對數的底)。 '
math.floor =
'回傳不大於`x` 的最大整數值。 '
math.fmod =
'回傳`x` 除以`y`,將商向零圓整後的餘數。 '
math.frexp =
'將`x` 分解為尾數與指數,回傳值符合`x = m * (2 ^ e)` 。 `e` 是一個整數,`m` 是[0.5, 1) 之間的規格化小數(`x` 為0時`m` 為0)。 '
math.huge =
'一個比任何數字值都大的浮點數。 '
math.ldexp =
'回傳`m * (2 ^ e)` 。 '
math.log['<5.1'] =
'回傳`x` 的自然對數。 '
math.log['>5.2'] =
'回以指定底的`x` 的對數。 '
math.log10 =
'回傳`x` 的以10為底的對數。 '
math.max =
'回傳參數中最大的值, 大小由Lua 操作`<` 決定。 '
math.maxinteger =
'最大值的整數。 '
math.min =
'回傳參數中最小的值, 大小由Lua 操作`<` 決定。 '
math.mininteger =
'最小值的整數。 '
math.modf =
'回傳`x` 的整數部分和小數部分。 '
math.pi =
'*π* 的值。 '
math.pow =
'回傳`x ^ y` 。 '
math.rad =
'將角`x` 從角度轉換為弧度。 '
math.random =
[[
* `math.random()`: 回傳[0,1) 區間內一致分佈的浮點偽隨機數。
* `math.random(n)`: 回傳[1, n] 區間內一致分佈的整數偽隨機數。
* `math.random(m, n)`: 回傳[m, n] 區間內一致分佈的整數偽隨機數。
]]
math.randomseed['<5.3'] =
'把`x` 設為偽隨機數發生器的“種子”: 相同的種子產生相同的隨機數列。 '
math.randomseed['>5.4'] =
[[
* `math.randomseed(x, y)`: 將`x` 與`y` 連接為128位的種子來重新初始化偽隨機生成器。
* `math.randomseed(x)`: 等同於`math.randomseed(x, 0)` 。
* `math.randomseed()`: 生成弱隨機性的種子
]]
math.sin =
'回傳`x` 的正弦值(假定參數是弧度)。 '
math.sinh =
'回傳`x` 的雙曲正弦值(假定參數是弧度)。 '
math.sqrt =
'回傳`x` 的平方根。 '
math.tan =
'回傳`x` 的正切值(假定參數是弧度)。 '
math.tanh =
'回傳`x` 的雙曲正切值(假定參數是弧度)。 '
math.tointeger =
'如果`x` 可以轉換為一個整數, 回傳該整數。 '
math.type =
'如果`x` 是整數,回傳`"integer"`, 如果它是浮點數,回傳`"float"`, 如果`x` 不是數字,回傳`nil`。 '
math.ult =
'如果整數`m` 和`n` 以無符號整數形式比較, `m` 在`n` 之下,回傳布林真否則回傳假。 '
os =
''
os.clock =
'回傳程式使用的按秒計CPU 時間的近似值。 '
os.date =
'回傳一個包含日期及時刻的字串或表。格式化方法取決於所給字串`format`。 '
os.difftime =
'回傳以秒計算的時刻`t1` 到`t2` 的差值。 '
os.execute =
'呼叫系統直譯器執行`command`。 '
os.exit['<5.1'] =
'呼叫C 函式`exit` 終止主機程式。 '
os.exit['>5.2'] =
'呼叫ISO C 函式`exit` 終止主機程式。 '
os.getenv =
'回傳行程環境變數`varname` 的值。 '
os.remove =
'刪除指定名字的檔案。 '
os.rename =
'將名字為`oldname` 的檔案或目錄更名為`newname`。 '
os.setlocale =
'設定程式的目前區域。 '
os.time =
'當不傳參數時,回傳目前時刻。如果傳入一張表,就回傳由這張表表示的時刻。 '
os.tmpname =
'回傳一個可用於臨時檔案的檔名字串。 '
osdate.year =
'四位數字'
osdate.month =
'1-12'
osdate.day =
'1-31'
osdate.hour =
'0-23'
osdate.min =
'0-59'
osdate.sec =
'0-61'
osdate.wday =
'星期幾,1-7,星期天為1'
osdate.yday =
'當年的第幾天,1-366'
osdate.isdst =
'夏令時標記,一個布林值'
package =
''
require['<5.3'] =
'載入一個模組,回傳該模組的回傳值(`nil`時為`true`)。 '
require['>5.4'] =
'載入一個模組,回傳該模組的回傳值(`nil`時為`true`)與搜尋器回傳的載入資料。預設搜尋器的載入資料指示了載入位置,對於檔案來說就是檔案路徑。 '
package.config =
'一個描述有一些為包管理準備的編譯期配置訊息的串。 '
package.cpath =
'這個路徑被`require` 在C 載入器中做搜尋時用到。 '
package.loaded =
'用於`require` 控制哪些模組已經被載入的表。 '
package.loaders =
'用於`require` 控制如何載入模組的表。 '
package.loadlib =
'讓主機程式動態連結C 庫`libname` 。 '
package.path =
'這個路徑被`require` 在Lua 載入器中做搜尋時用到。 '
package.preload =
'儲存有一些特殊模組的載入器。 '
package.searchers =
'用於`require` 控制如何載入模組的表。 '
package.searchpath =
'在指定`path` 中搜尋指定的`name` 。 '
package.seeall =
'給`module` 設定一個元表,該元表的`__index` 域為全域環境,這樣模組便會繼承全域環境的值。可作為`module` 函式的選項。 '
string =
''
string.byte =
'回傳字元`s[i]`, `s[i+1]`, ... ,`s[j]` 的內部數字編碼。 '
string.char =
'接收零或更多的整數。回傳和參數數量相同長度的字串。其中每個字元的內部編碼值等於對應的參數值。 '
string.dump =
'回傳包含有以二進制方式表示的(一個*二進制程式碼區塊* )指定函式的字串。 '
string.find =
'查找第一個字串中匹配到的`pattern`(參見§6.4.1)。 '
string.format =
'回傳不定數量參數的格式化版本,格式化串為第一個參數。 '
string.gmatch =
[[
回傳一個疊代器函式。每次呼叫這個函式都會繼續以`pattern` (參見§6.4.1) 對s 做匹配,並回傳所有捕獲到的值。
下面這個例子會循環疊代字串s 中所有的單詞, 並逐行列印:
```lua
s =
"hello world from Lua"
for w in string.gmatch(s, "%a+") do
print(w)
end
```
]]
string.gsub =
'將字串s 中,所有的(或是在n 給出時的前n 個) pattern (參見§6.4.1)都替換成repl ,並回傳其副本。 '
string.len =
'回傳其長度。 '
string.lower =
'將其中的大寫字元都轉為小寫後回傳其副本。 '
string.match =
'在字串s 中找到第一個能用pattern (參見§6.4.1)匹配到的部分。如果能找到,match 回傳其中的捕獲物; 否則回傳nil 。 '
string.pack =
'回傳一個打包了(即以二進制形式序列化) v1, v2 等值的二進制字串。字串fmt 為打包格式(參見§6.4.2)。 '
string.packsize =
[[回傳以指定格式用$string.pack 打包的字串的長度。格式化字串中不可以有變長選項's' 或'z' (參見§6.4.2)。 ]]
string.rep['<5.1'] =
'回傳`n` 個字串`s` 連在一起的字串。如果`n` 不是正數則回傳空串。 '
string.rep['>5.2'] =
'回傳`n` 個字串`s` 以字串`sep` 為分割符連在一起的字串。預設的`sep` 值為空字串(即沒有分割符)。如果`n` 不是正數則回傳空串。 '
string.reverse =
'回傳字串s 的翻轉串。 '
string.sub =
'回傳字串的子串, 該子串從`i` 開始到`j` 為止。 '
string.unpack =
'回傳以格式fmt (參見§6.4.2) 打包在字串s (參見string.pack) 中的值。 '
string.upper =
'接收一個字串,將其中的小寫字元都轉為大寫後回傳其副本。 '
table =
''
table.concat =
'提供一個列表,其所有元素都是字串或數字,回傳字串`list[i]..sep..list[i+1] ··· sep..list[j]`。 '
table.insert =
'在`list` 的位置`pos` 處插入元素`value`。 '
table.maxn =
'回傳給定表的最大正數索引,如果表沒有正數索引,則回傳零。 '
table.move =
[[
將元素從表`a1` 移到表`a2`。
```lua
a2[t],··· =
a1[f],···,a1[e]
return a2
```
]]
table.pack =
'回傳用所有參數以鍵`1`,`2`, 等填充的新表, 並將`"n"` 這個域設為參數的總數。 '
table.remove =
'移除`list` 中`pos` 位置上的元素,並回傳這個被移除的值。 '
table.sort =
'在表內從`list[1]` 到`list[#list]` *原地* 對其間元素按指定次序排序。 '
table.unpack =
[[
回傳列表中的元素。這個函式等價於
```lua
return list[i], list[i+1], ···, list[j]
```
i 預設為1 ,j 預設為#list。
]]
utf8 =
''
utf8.char =
'接收零或多個整數, 將每個整數轉換成對應的UTF-8 字元序列,並回傳這些序列連接到一起的字串。 '
utf8.charpattern =
'用於精確匹配到一個UTF-8 字元序列的模式,它假定處理的對象是一個合法的UTF-8 字串。 '
utf8.codes =
[[
回傳一系列的值,可以讓
```lua
for p, c in utf8.codes(s) do
body
end
```
疊代出字串s 中所有的字元。這裡的p 是位置(按字元數)而c 是每個字元的編號。如果處理到一個不合法的字元序列,將拋出一個錯誤。
]]
utf8.codepoint =
'以整數形式回傳`s` 中從位置`i` 到`j` 間(包括兩端) 所有字元的編號。 '
utf8.len =
'回傳字串`s` 中從位置`i` 到`j` 間(包括兩端) UTF-8 字元的個數。 '
utf8.offset =
'回傳編碼在`s` 中的第`n` 個字元的開始位置(按字元數) (從位置`i` 處開始統計)。 '
|