Lua - biblioteki standardowe

Error Handling

Obejmuje funkcje obsługi błędów, takie jak assert, error, jak wyjaśniono w Lua - Obsługa błędów .

Memory Management

Zawiera funkcje automatycznego zarządzania pamięcią związane z usuwaniem elementów bezużytecznych, jak wyjaśniono w Lua - Garbage Collection .

dofile ([filename])

Otwiera plik i wykonuje zawartość pliku jako fragment. Jeśli nie zostanie przekazany żaden parametr, funkcja ta wykonuje zawartość standardowego wejścia. Błędy zostaną przesłane do wywołującego.

_G

Tak więc jest zmienną globalną, która przechowuje globalne środowisko (to znaczy _G._G = _G). Sam Lua nie używa tej zmiennej.

getfenv ([f])

Zwraca bieżące środowisko używane przez funkcję. f może być funkcją Lua lub liczbą określającą funkcję na tym poziomie stosu - Poziom 1 to funkcja wywołująca getfenv. Jeśli dana funkcja nie jest funkcją Lua lub f wynosi 0, getfenv zwraca środowisko globalne. Wartość domyślna f to 1.

getmetatable (object)

Jeśli obiekt nie ma metatabeli, zwraca nil. W przeciwnym razie, jeśli metatablica obiektu ma pole „__metatable”, zwraca skojarzoną wartość. W przeciwnym razie zwraca metatabelę danego obiektu.

ipairs (t)

Ta funkcja pobiera indeksy i wartości z tabel.

load (func [, chunkname])

Wczytuje fragment za pomocą funkcji func, aby pobrać jego fragmenty. Każde wywołanie funkcji func musi zwrócić ciąg, który jest zgodny z poprzednimi wynikami.

loadfile ([filename]))

Podobne do load, ale pobiera porcję z pliku nazwa_pliku lub ze standardowego wejścia, jeśli nie podano nazwy pliku.

loadstring (string [, chunkname])

Podobne do load, ale pobiera fragment z podanego ciągu.

next (table [, index])

Umożliwia programowi przechodzenie przez wszystkie pola tabeli. Jego pierwszym argumentem jest tabela, a drugim indeksem w tej tabeli. next zwraca następny indeks tabeli i związaną z nim wartość.

pairs (t)

Zawiesza uruchomiony program. Parametr przekazany do tej metody działa jako dodatkowe wartości zwracane do funkcji wznawiania.

print (...)

Zawiesza uruchomiony program. Parametr przekazany do tej metody działa jako dodatkowe wartości zwracane do funkcji wznawiania.

rawequal (v1, v2)

Sprawdza, czy v1 jest równe v2, bez wywoływania żadnej metametody. Zwraca wartość logiczną.

rawget (table, index)

Pobiera rzeczywistą wartość tabeli [indeks] bez wywoływania żadnej metametody. tabela musi być stołem; indeks może mieć dowolną wartość.

rawset (table, index, value)

Ustawia rzeczywistą wartość tabeli [indeks] na wartość, bez wywoływania żadnej metametody. tabela musi być tabelą, indeksować dowolną wartość inną niż nil i zawierać dowolną wartość Lua. Ta funkcja zwraca tabelę.

select (index, ...)

Jeśli indeks jest liczbą, zwraca wszystkie argumenty po indeksie numeru argumentu. W przeciwnym razie indeks musi być ciągiem „#”, a funkcja select zwraca całkowitą liczbę otrzymanych dodatkowych argumentów.

setfenv (f, table)

Ustawia środowisko, które ma być używane przez daną funkcję. f może być funkcją Lua lub liczbą określającą funkcję na tym poziomie stosu - Poziom 1 to funkcja wywołująca setfenv. setfenv zwraca podaną funkcję. W szczególnym przypadku, gdy f wynosi 0, setfenv zmienia środowisko działającego wątku. W tym przypadku setfenv nie zwraca żadnych wartości.

setmetatable (table, metatable)

Ustawia metatabelę dla danej tabeli. (Nie możesz zmienić metatabli innych typów z Lua, tylko z C.) Jeśli metatablica jest zerowa, usuwa metatabelę z podanej tabeli. Jeśli oryginalna metatablica ma pole „__metatable”, zgłasza błąd. Ta funkcja zwraca tabelę.

tonumber (e [, base])

Próbuje zamienić argument na liczbę. Jeśli argument jest już liczbą lub łańcuchem zamiennym na liczbę, to tonumber zwraca tę liczbę; w przeciwnym razie zwraca nil.

tostring (e)

Odbiera argument dowolnego typu i konwertuje go na ciąg w rozsądnym formacie. Aby uzyskać pełną kontrolę nad konwersją liczb, użyj string.format.

type (v)

Zwraca typ jedynego argumentu zakodowanego jako ciąg. Możliwe wyniki tej funkcji to „nil” (ciąg znaków, a nie wartość nil), „liczba”, „ciąg znaków”, „wartość logiczna”, „tabela”, „funkcja”, „wątek” i „dane użytkownika”.

unpack (list [, i [, j]])

Zwraca elementy z podanej tabeli.

_VERSION

Zmienna globalna (nie funkcja), która przechowuje łańcuch zawierający aktualną wersję interpretera. Bieżąca zawartość tej zmiennej to „Lua 5.1”.

Coroutines

Zawiera funkcje manipulacji programami, jak wyjaśniono w Lua - Coroutines .