Lua – Thư viện tiêu chuẩn

---

 Trang trướcTrang tiếp theo  

Thư viện tiêu chuẩn Lua cung cấp một bộ hàm phong phú được triển khai trực tiếp với API C và được tích hợp sẵn với ngôn ngữ lập trình Lua. Các thư viện này cung cấp các dịch vụ bên trong ngôn ngữ lập trình Lua và cả các dịch vụ bên ngoài như hoạt động tệp và db.

Các thư viện tiêu chuẩn này được xây dựng trong API C chính thức được cung cấp dưới dạng các mô-đun C riêng biệt. Nó bao gồm những điều sau:

• Thư viện cơ bản, bao gồm thư viện con của coroutine
• Thư viện mô-đun
• Thao tác với chuỗi
• Thao tác bảng
• Thư viện toán học
• Đầu vào và đầu ra tệp
• Hệ điều hành cơ sở vật chất
• Cơ sở gỡ lỗi

Thư viện cơ bản

Chúng tôi đã sử dụng thư viện cơ bản trong suốt hướng dẫn theo các chủ đề khác nhau. Bảng sau cung cấp liên kết của các trang liên quan và liệt kê các chức năng được đề cập trong các phần khác nhau của hướng dẫn Lua này.

Sr.No.	Thư viện / Phương pháp & Mục đích
1	Xử lý lỗiBao gồm các chức năng xử lý lỗi như khẳng định, lỗi như được giải thích trong Lua – Xử lý lỗi .
2	Quản lý bộ nhớBao gồm các chức năng quản lý bộ nhớ tự động liên quan đến thu gom rác như được giải thích trong Lua – Garbage Collection .
3	dofile ([tên tệp])Nó mở tệp và thực thi nội dung của tệp dưới dạng một đoạn. Nếu không có tham số nào được truyền, thì hàm này thực thi nội dung của đầu vào chuẩn. Các lỗi sẽ được thông báo cho người gọi.
4	_NSDo đó, biến toàn cục nắm giữ môi trường toàn cục (nghĩa là, _G._G = _G). Bản thân Lua không sử dụng biến này.
5	getfenv ([f])Trả về môi trường hiện tại được sử dụng bởi hàm. f có thể là một hàm Lua hoặc một số chỉ định hàm ở mức ngăn xếp đó – Mức 1 là hàm gọi getfenv. Nếu hàm đã cho không phải là hàm Lua hoặc nếu f bằng 0, getfenv trả về môi trường toàn cục. Giá trị mặc định cho f là 1.
6	getmetatable (đối tượng)Nếu đối tượng không có đối tượng, trả về nil. Ngược lại, nếu đối tượng có thể đo được có trường “__metatable”, sẽ trả về giá trị được liên kết. Nếu không, trả về khả năng đáp ứng của đối tượng đã cho.
7	ipairs (t)Hàm này tìm nạp các chỉ số và giá trị của bảng.
số 8	tải (func [, chunkname])Tải một đoạn bằng cách sử dụng hàm func để lấy các mảnh của nó. Mỗi lệnh gọi đến func phải trả về một chuỗi nối với các kết quả trước đó.
9	loadfile ([tên tệp]))Tương tự như tải, nhưng lấy đoạn từ tên tệp hoặc từ đầu vào chuẩn, nếu không có tên tệp nào được cung cấp.
10	chuỗi tải (string [, chunkname])Tương tự như tải, nhưng lấy đoạn từ chuỗi đã cho.
11	tiếp theo (bảng [, chỉ mục])Cho phép chương trình duyệt qua tất cả các trường của bảng. Đối số đầu tiên của nó là một bảng và đối số thứ hai của nó là một chỉ mục trong bảng này. next trả về chỉ mục tiếp theo của bảng và giá trị liên quan của nó.
12	cặp (t)Tạm dừng quy trình đăng ký đang chạy. Tham số được truyền cho phương thức này hoạt động như các giá trị trả về bổ sung cho hàm tiếp tục.
13	in (…)Tạm dừng quy trình đăng ký đang chạy. Tham số được truyền cho phương thức này hoạt động như các giá trị trả về bổ sung cho hàm tiếp tục.
14	rawequal (v1, v2)Kiểm tra xem v1 có bằng v2 hay không mà không cần gọi bất kỳ metamethod nào. Trả về một boolean.
15	rawget (bảng, chỉ mục)Nhận giá trị thực của bảng [index], mà không cần gọi bất kỳ metamethod nào. table phải là một cái bàn; chỉ mục có thể là bất kỳ giá trị nào.
16	rawset (bảng, chỉ mục, giá trị)Đặt giá trị thực của bảng [index] thành giá trị, mà không cần gọi bất kỳ phương thức siêu tốc nào. bảng phải là một bảng, lập chỉ mục bất kỳ giá trị nào khác với nil và đánh giá bất kỳ giá trị Lua nào. Hàm này trả về bảng.
17	chọn (chỉ mục, …)Nếu chỉ mục là một số, trả về tất cả các đối số sau chỉ mục số đối số. Nếu không, chỉ mục phải là chuỗi “#” và select trả về tổng số đối số bổ sung mà nó nhận được.
18	setfenv (f, bảng)Đặt môi trường sẽ được sử dụng bởi hàm đã cho. f có thể là một hàm Lua hoặc một số chỉ định hàm ở mức ngăn xếp đó – Mức 1 là hàm gọi setfenv. setfenv trả về hàm đã cho. Là một trường hợp đặc biệt, khi f bằng 0 setfenv thay đổi môi trường của luồng đang chạy. Trong trường hợp này, setfenv không trả về giá trị nào.
19	thiết lập được (bảng, có thể đo được)Đặt khả năng đáp ứng cho bảng đã cho. (Bạn không thể thay đổi phép đo đếm được của các loại khác từ Lua, chỉ từ C.) Nếu độ đo được bằng không, hãy loại bỏ độ đo được của bảng đã cho. Nếu hệ thống đo lường ban đầu có trường “__metatable”, thì sẽ xảy ra lỗi. Hàm này trả về bảng.
20	tonumber (e [, base])Cố gắng chuyển đối số của nó thành một số. Nếu đối số đã là một số hoặc một chuỗi có thể chuyển đổi thành số, thì tonumber trả về số này; nếu không, nó trả về nil.
21	dây (e)Nhận một đối số thuộc bất kỳ loại nào và chuyển đổi nó thành một chuỗi ở một định dạng hợp lý. Để kiểm soát hoàn toàn cách các số được chuyển đổi, hãy sử dụng string.format.
22	loại (v)Trả về kiểu đối số duy nhất của nó, được mã hóa dưới dạng chuỗi. Các kết quả có thể có của hàm này là “nil” (một chuỗi, không phải giá trị nil), “number”, “string”, “boolean”, “table”, “function”, “thread” và “userdata”.
23	giải nén (danh sách [, i [, j]])Trả về các phần tử từ bảng đã cho.
24	_PHIÊN BẢNMột biến toàn cục (không phải một hàm) chứa một chuỗi chứa phiên bản thông dịch hiện tại. Nội dung hiện tại của biến này là “Lua 5.1”.
25	CoroutinesBao gồm các chức năng thao tác trên quy trình như được giải thích trong Lua – Coroutines .

Sr.No.	Library / Method & Purpose
1	Error HandlingIncludes error handling functions like assert, error as explained in Lua – Error Handling.
2	Memory ManagementIncludes the automatic memory management functions related to garbage collection as explained in Lua – Garbage Collection.
3	dofile ([filename])It opens the file and executes the contents of the file as a chunk. If no parameter is passed, then this function executes the contents of standard input. The errors will be propagated to the caller.
4	_GThus is the global variable that holds the global environment (that is, _G._G = _G). Lua itself does not use this variable.
5	getfenv ([f])Returns the current environment in use by the function. f can be a Lua function or a number that specifies the function at that stack level − Level 1 is the function calling getfenv. If the given function is not a Lua function, or if f is 0, getfenv returns the global environment. The default for f is 1.
6	getmetatable (object)If object does not have a metatable, returns nil. Otherwise, if the object’s metatable has a “__metatable” field, returns the associated value. Otherwise, returns the metatable of the given object.
7	ipairs (t)This functions fetches the indices and values of tables.
8	load (func [, chunkname])Loads a chunk using function func to get its pieces. Each call to func must return a string that concatenates with previous results.
9	loadfile ([filename]))Similar to load, but gets the chunk from file filename or from the standard input, if no file name is given.
10	loadstring (string [, chunkname])Similar to load, but gets the chunk from the given string.
11	next (table [, index])Allows a program to traverse all fields of a table. Its first argument is a table and its second argument is an index in this table. next returns the next index of the table and its associated value.
12	pairs (t)Suspends the running coroutine. The parameter passed to this method acts as additional return values to the resume function.
13	print (…)Suspends the running coroutine. The parameter passed to this method acts as additional return values to the resume function.
14	rawequal (v1, v2)Checks whether v1 is equal to v2, without invoking any metamethod. Returns a boolean.
15	rawget (table, index)Gets the real value of table[index], without invoking any metamethod. table must be a table; index may be any value.
16	rawset (table, index, value)Sets the real value of table[index] to value, without invoking any metamethod. table must be a table, index any value different from nil, and value any Lua value. This function returns table.
17	select (index, …)If index is a number, returns all arguments after argument number index. Otherwise, index must be the string “#”, and select returns the total number of extra arguments it received.
18	setfenv (f, table)Sets the environment to be used by the given function. f can be a Lua function or a number that specifies the function at that stack level − Level 1 is the function calling setfenv. setfenv returns the given function. As a special case, when f is 0 setfenv changes the environment of the running thread. In this case, setfenv returns no values.
19	setmetatable (table, metatable)Sets the metatable for the given table. (You cannot change the metatable of other types from Lua, only from C.) If metatable is nil, removes the metatable of the given table. If the original metatable has a “__metatable” field, raises an error. This function returns table.
20	tonumber (e [, base])Tries to convert its argument to a number. If the argument is already a number or a string convertible to a number, then tonumber returns this number; otherwise, it returns nil.
21	tostring (e)Receives an argument of any type and converts it to a string in a reasonable format. For complete control of how numbers are converted, use string.format.
22	type (v)Returns the type of its only argument, coded as a string. The possible results of this function are “nil” (a string, not the value nil), “number”, “string”, “boolean”, “table”, “function”, “thread”, and “userdata”.
23	unpack (list [, i [, j]])Returns the elements from the given table.
24	_VERSIONA global variable (not a function) that holds a string containing the current interpreter version. The current contents of this variable is “Lua 5.1”.
25	CoroutinesIncludes the coroutine manipulation functions as explained in Lua – Coroutines.

Thư viện mô-đun

Thư viện mô-đun cung cấp các chức năng cơ bản để tải mô-đun trong Lua. Nó xuất trực tiếp một hàm trong môi trường toàn cầu: request. Mọi thứ khác được xuất trong một gói bảng. Chi tiết về thư viện mô-đun được giải thích trong chương trước Lua – Hướng dẫn về mô-đun .

Thao tác với chuỗi

Lua cung cấp một tập hợp các hàm thao tác chuỗi phong phú. Hướng dẫn Lua – Strings trước đó sẽ trình bày chi tiết về vấn đề này.

Thao tác bảng

Lua phụ thuộc vào các bảng trong hầu hết các hoạt động của nó. Hướng dẫn Lua – Tables trước đó sẽ trình bày chi tiết về vấn đề này.

Đầu vào và đầu ra tệp

Chúng ta thường cần cơ sở lưu trữ dữ liệu trong lập trình và điều này được cung cấp bởi các hàm thư viện tiêu chuẩn cho I / O tệp trong Lua. Nó được thảo luận trong hướng dẫn Lua – File I / O trước đó .

Cơ sở gỡ lỗi

Lua cung cấp một thư viện gỡ lỗi cung cấp tất cả các chức năng nguyên thủy để chúng tôi tạo trình gỡ lỗi của riêng mình. Nó được thảo luận trong Lua – hướng dẫn gỡ lỗi trước đó .