Lua - Bibliothèques standard

Error Handling

Inclut des fonctions de gestion des erreurs comme assert, error comme expliqué dans Lua - Error Handling .

Memory Management

Inclut les fonctions de gestion automatique de la mémoire liées au garbage collection comme expliqué dans Lua - Garbage Collection .

dofile ([filename])

Il ouvre le fichier et exécute le contenu du fichier comme un morceau. Si aucun paramètre n'est passé, cette fonction exécute le contenu de l'entrée standard. Les erreurs seront propagées à l'appelant.

_G

Ainsi est la variable globale qui contient l'environnement global (c'est-à-dire _G._G = _G). Lua elle-même n'utilise pas cette variable.

getfenv ([f])

Renvoie l'environnement actuel utilisé par la fonction. f peut être une fonction Lua ou un nombre qui spécifie la fonction à ce niveau de pile - Le niveau 1 est la fonction appelant getfenv. Si la fonction donnée n'est pas une fonction Lua, ou si f vaut 0, getfenv renvoie l'environnement global. La valeur par défaut pour f est 1.

getmetatable (object)

Si l'objet n'a pas de métatable, renvoie nil. Sinon, si la métatable de l'objet a un champ «__metatable», renvoie la valeur associée. Sinon, retourne la métatable de l'objet donné.

ipairs (t)

Cette fonction récupère les indices et les valeurs des tables.

load (func [, chunkname])

Charge un morceau en utilisant la fonction func pour obtenir ses morceaux. Chaque appel à func doit retourner une chaîne qui concatène avec les résultats précédents.

loadfile ([filename]))

Similaire à load, mais obtient le morceau à partir du nom du fichier ou de l'entrée standard, si aucun nom de fichier n'est donné.

loadstring (string [, chunkname])

Similaire à load, mais obtient le morceau de la chaîne donnée.

next (table [, index])

Permet à un programme de parcourir tous les champs d'une table. Son premier argument est une table et son second argument est un index de cette table. next renvoie l'index suivant de la table et sa valeur associée.

pairs (t)

Suspend la coroutine en cours d'exécution. Le paramètre passé à cette méthode agit comme des valeurs de retour supplémentaires pour la fonction de reprise.

print (...)

Suspend la coroutine en cours d'exécution. Le paramètre passé à cette méthode agit comme des valeurs de retour supplémentaires pour la fonction de reprise.

rawequal (v1, v2)

Vérifie si v1 est égal à v2, sans invoquer de métaméthode. Renvoie un booléen.

rawget (table, index)

Obtient la valeur réelle de table [index], sans appeler de métaméthode. la table doit être une table; index peut être n'importe quelle valeur.

rawset (table, index, value)

Définit la valeur réelle de table [index] sur value, sans invoquer de métaméthode. table doit être une table, indexer toute valeur différente de nil et valoriser toute valeur Lua. Cette fonction renvoie une table.

select (index, ...)

Si index est un nombre, renvoie tous les arguments après le numéro d'argument index. Sinon, index doit être la chaîne "#" et select renvoie le nombre total d'arguments supplémentaires reçus.

setfenv (f, table)

Définit l'environnement à utiliser par la fonction donnée. f peut être une fonction Lua ou un nombre qui spécifie la fonction à ce niveau de pile - Le niveau 1 est la fonction appelant setfenv. setfenv renvoie la fonction donnée. Dans un cas particulier, lorsque f vaut 0, setfenv modifie l'environnement du thread en cours d'exécution. Dans ce cas, setfenv ne renvoie aucune valeur.

setmetatable (table, metatable)

Définit la métatable pour la table donnée. (Vous ne pouvez pas modifier la métatable d'autres types à partir de Lua, uniquement à partir de C.) Si métatable est nul, supprime la métatable de la table donnée. Si le métatable d'origine a un champ «__metatable», génère une erreur. Cette fonction retourne table.

tonumber (e [, base])

Tente de convertir son argument en nombre. Si l'argument est déjà un nombre ou une chaîne convertible en nombre, alors tonumber renvoie ce nombre; sinon, il renvoie nul.

tostring (e)

Reçoit un argument de n'importe quel type et le convertit en une chaîne dans un format raisonnable. Pour un contrôle complet de la façon dont les nombres sont convertis, utilisez string.format.

type (v)

Renvoie le type de son seul argument, codé sous forme de chaîne. Les résultats possibles de cette fonction sont "nil" (une chaîne, pas la valeur nil), "number", "string", "boolean", "table", "function", "thread" et "userdata".

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

Renvoie les éléments de la table donnée.

_VERSION

Une variable globale (pas une fonction) qui contient une chaîne contenant la version actuelle de l'interpréteur. Le contenu actuel de cette variable est "Lua 5.1".

Coroutines

Inclut les fonctions de manipulation de coroutine comme expliqué dans Lua - Coroutines .