765 lines
34 KiB
Lua
765 lines
34 KiB
Lua
|
---@diagnostic disable: undefined-global, lowercase-global
|
|||
|
|
|
|||
|
|
arg =
|
|||
|
|
'Argumentos de inicialização para a versão standalone da linguagem Lua.'
|
|||
|
|
|
|||
|
|
assert =
|
|||
|
|
'Emite um erro se o valor de seu argumento v for falso (i.e., `nil` ou `false`); caso contrário, devolve todos os seus argumentos. Em caso de erro, `message` é o objeto de erro que, quando ausente, por padrão é `"assertion failed!"`'
|
|||
|
|
|
|||
|
|
cgopt.collect =
|
|||
|
|
'Realiza um ciclo completo de coleta de lixo (i.e., garbage-collection cycle).'
|
|||
|
|
cgopt.stop =
|
|||
|
|
'Interrompe a execução automática.'
|
|||
|
|
cgopt.restart =
|
|||
|
|
'Reinicia a execução automática.'
|
|||
|
|
cgopt.count =
|
|||
|
|
'Retorna, em Kbytes, a quantidade total de memória utilizada pela linguagem Lua.'
|
|||
|
|
cgopt.step =
|
|||
|
|
'Executa a coleta de lixo (i.e., garbage-collection) em uma única etapa. A quantidade de execuções por etapa é controlada via `arg`.'
|
|||
|
|
cgopt.setpause =
|
|||
|
|
'Estabelece pausa. Defina via `arg` o intervalo de pausa do coletor de lixo (i.e., garbage-collection).'
|
|||
|
|
cgopt.setstepmul =
|
|||
|
|
'Estabelece um multiplicador para etapa de coleta de lixo (i.e., garbage-collection). Defina via `arg` o valor multiplicador.'
|
|||
|
|
cgopt.incremental =
|
|||
|
|
'Altera o modo do coletor para incremental.'
|
|||
|
|
cgopt.generational =
|
|||
|
|
'Altera o modo do coletor para geracional.'
|
|||
|
|
cgopt.isrunning =
|
|||
|
|
'Retorna um valor booleano indicando se o coletor de lixo (i.e., garbage-collection) está em execução.'
|
|||
|
|
|
|||
|
|
collectgarbage =
|
|||
|
|
'Esta função é uma interface genérica para o coletor de lixo (i.e., garbage-collection). Ela executa diferentes funções de acordo com seu primeiro argumento, `opt`.'
|
|||
|
|
|
|||
|
|
dofile =
|
|||
|
|
'Abre o arquivo fornecido por argumento e executa seu conteúdo como código Lua. Quando chamado sem argumentos, `dofile` executa o conteúdo da entrada padrão (`stdin`). Retorna todos os valores retornados pelo trecho de código contido no arquivo. Em caso de erros, o `dofile` propaga o erro para seu chamador. Ou seja, o `dofile` não funciona em modo protegido.'
|
|||
|
|
|
|||
|
|
error =
|
|||
|
|
[[
|
|||
|
|
Termina a última chamada de função protegida e retorna `message` como objeto de `erro`.
|
|||
|
|
|
|||
|
|
Normalmente, o 'erro' adiciona algumas informações sobre a localização do erro no início da mensagem, quando a mensagem for uma string.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
_G =
|
|||
|
|
'Uma variável global (não uma função) que detém o ambiente global (ver §2.2). Lua em si não usa esta variável; mudar seu valor não afeta nenhum ambiente e vice-versa.'
|
|||
|
|
|
|||
|
|
getfenv =
|
|||
|
|
'Retorna o ambiente atual em uso pela função. O `f` pode ser uma função Lua ou um número que especifica a função naquele nível de pilha.'
|
|||
|
|
|
|||
|
|
getmetatable =
|
|||
|
|
'Se o objeto não tiver uma metatable, o retorno é `nil`. Mas caso a metatable do objeto tenha um campo `__metatable`, é retornado o valor associado. Caso contrário, retorna a metatable do objeto dado.'
|
|||
|
|
|
|||
|
|
ipairs =
|
|||
|
|
[[
|
|||
|
|
Retorna três valores (uma função iteradora, a tabela `t`, e `0`) para que a seguinte construção
|
|||
|
|
```lua
|
|||
|
|
for i,v in ipairs(t) do body end
|
|||
|
|
```
|
|||
|
|
possa iterar sobre os pares de valor-chave `(1,t[1]), (2,t[2]), ...`, até o primeiro índice ausente.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
loadmode.b =
|
|||
|
|
'Somente blocos binários.'
|
|||
|
|
loadmode.t =
|
|||
|
|
'Somente blocos de texto.'
|
|||
|
|
loadmode.bt =
|
|||
|
|
'Tanto binário quanto texto.'
|
|||
|
|
|
|||
|
|
load['<5.1'] =
|
|||
|
|
'Carrega um bloco utilizando a função `func` para obter suas partes. Cada chamada para o `func` deve retornar uma string que é concatenada com os resultados anteriores.'
|
|||
|
|
load['>5.2'] =
|
|||
|
|
[[
|
|||
|
|
Carrega um bloco.
|
|||
|
|
|
|||
|
|
Se o bloco (i.e., `chunk`) é uma string, o bloco é essa string. Se o bloco é uma função, a função "load" é chamada repetidamente para obter suas partes. Cada chamada para o bloco deve retornar uma string que é concatenada com os resultados anteriores. O fim do bloco é sinalizado com o retorno de uma string vazia ou `nil`.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
loadfile =
|
|||
|
|
'Carrega um bloco de arquivo `filename` ou da entrada padrão, se nenhum nome de arquivo for dado.'
|
|||
|
|
|
|||
|
|
loadstring =
|
|||
|
|
'Carrega um bloco a partir de uma string dada.'
|
|||
|
|
|
|||
|
|
module =
|
|||
|
|
'Cria um módulo.'
|
|||
|
|
|
|||
|
|
next =
|
|||
|
|
[[
|
|||
|
|
Permite que um programa percorra todos os campos de uma tabela. Seu primeiro argumento é uma tabela e seu segundo argumento é um índice nesta tabela. Uma chamada `next` retorna o próximo índice da tabela e seu valor associado. Quando chamado usando `nil` como segundo argumento, `next` retorna um índice inicial e seu valor associado. Quando chamado com o último índice, ou com `nil` em uma tabela vazia, o `next` retorna o `nil`. Se o segundo argumento estiver ausente, então é interpretado como `nil`. Portanto, pode-se utilizar o `next(t)` para verificar se uma tabela está vazia.
|
|||
|
|
|
|||
|
|
A ordem na qual os índices são enumerados não é especificada, *mesmo para índices numéricos*. (Para percorrer uma tabela em ordem numérica, utilize um `for`).
|
|||
|
|
|
|||
|
|
O comportamento do `next` é indefinido se, durante a iteração/travessia, você atribuir qualquer valor a um campo inexistente na tabela. Você pode, entretanto, modificar os campos existentes e pode, inclusive, os definir como nulos.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
pairs =
|
|||
|
|
[[
|
|||
|
|
Se `t` tem um "meta" método (i.e., metamethod) `__pairs`, a chamada é feita usando t como argumento e retorna os três primeiros resultados.
|
|||
|
|
|
|||
|
|
Caso contrário, retorna três valores: a função $next, a tabela `t` e `nil`, para que a seguinte construção
|
|||
|
|
```lua
|
|||
|
|
for k,v in pairs(t) do body end
|
|||
|
|
```
|
|||
|
|
possa iterar sobre todos os pares de valor-chave da tabela 't'.
|
|||
|
|
|
|||
|
|
Veja a função $next para saber as ressalvas em modificar uma tabela durante sua iteração.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
pcall =
|
|||
|
|
[[
|
|||
|
|
Chama a função `f` com os argumentos dados em modo *protegido*. Isto significa que qualquer erro dentro de `f` não é propagado; em vez disso, o `pcall` captura o erro e retorna um código de status. Seu primeiro resultado é o código de status (booleano), que é verdadeiro se a chamada for bem sucedida sem erros. Neste caso, `pcall' também retorna todos os resultados da chamada, após este primeiro resultado. Em caso de qualquer erro, `pcall` retorna `false` mais o objeto de erro.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
print =
|
|||
|
|
[[
|
|||
|
|
Recebe qualquer número de argumentos e imprime seus valores na saída padrão `stdout`, convertendo cada argumento em uma string seguindo as mesmas regras do $tostring.
|
|||
|
|
A função `print` não é destinada à saída formatada, mas apenas como uma forma rápida de mostrar um valor, por exemplo, para debugging. Para controle completo sobre a saída, use $string.format e $io.write.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
rawequal =
|
|||
|
|
'Verifica se v1 é igual a v2, sem invocar a metatable `__eq`.'
|
|||
|
|
|
|||
|
|
rawget =
|
|||
|
|
'Obtém o valor real de `table[index]`, sem invocar a metatable `__index`.'
|
|||
|
|
|
|||
|
|
rawlen =
|
|||
|
|
'Retorna o comprimento do objeto `v`, sem invocar a metatable `__len`.'
|
|||
|
|
|
|||
|
|
rawset =
|
|||
|
|
[[
|
|||
|
|
Define o valor real de `table[index]` para `value`, sem utilizar o metavalue `__newindex`. `table` deve ser uma tabela, `index` qualquer valor diferente de `nil` e `NaN`, e `value` qualquer valor de tipos do Lua.
|
|||
|
|
Esta função retorna uma `table`.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
select =
|
|||
|
|
'Se `index` é um número, retorna todos os argumentos após o número do argumento `index`; um número negativo de índices do final (`-1` é o último argumento). Caso contrário, `index` deve ser a string `"#"`, e `select` retorna o número total de argumentos extras dados.'
|
|||
|
|
|
|||
|
|
setfenv =
|
|||
|
|
'Define o ambiente a ser utilizado pela função em questão.'
|
|||
|
|
|
|||
|
|
setmetatable =
|
|||
|
|
[[
|
|||
|
|
Define a metatable para a tabela dada. Se `metatabela` for `nil`, remove a metatable da tabela em questão. Se a metatable original tiver um campo `__metatable', um erro é lançado.
|
|||
|
|
|
|||
|
|
Esta função retorna uma `table`.
|
|||
|
|
|
|||
|
|
Para alterar a metatable de outros tipos do código Lua, você deve utilizar a biblioteca de debugging (§6.10).
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
tonumber =
|
|||
|
|
[[
|
|||
|
|
Quando chamado sem a base, `tonumber` tenta converter seu argumento para um número. Se o argumento já for um número ou uma string numérica, então `tonumber` retorna este número; caso contrário, retorna `fail`.
|
|||
|
|
|
|||
|
|
A conversão de strings pode resultar em números inteiros ou de ponto flutuante, de acordo com as convenções lexicais de Lua (ver §3.1). A string pode ter espaços antes e depois e um sinal.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
tostring =
|
|||
|
|
[[
|
|||
|
|
Recebe um valor de qualquer tipo e o converte em uma string em formato legível por humanos.
|
|||
|
|
|
|||
|
|
Se a metatable de `v` tem um campo `__tostring', então `tostring' chama o valor correspondente usando `v` como argumento, e utiliza o resultado da chamada como seu resultado. Caso contrário, se a metatable de `v` tiver um campo `__name` com um valor do tipo string, `tostring` pode utilizar essa string em seu resultado final.
|
|||
|
|
|
|||
|
|
Para controle completo de como os números são convertidos, utilize $string.format.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
type =
|
|||
|
|
[[
|
|||
|
|
Retorna o tipo de seu único argumento, codificado como uma string. Os resultados possíveis desta função são `"nil"` (uma string, não o valor `nil`), `"number"`, `"string"`, `"boolean"`, `"table"`, `"function"`, `"thread"`, e `"userdata"`.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
_VERSION =
|
|||
|
|
'Uma variável global (não uma função) que contém uma string contendo a versão Lua em execução.'
|
|||
|
|
|
|||
|
|
warn =
|
|||
|
|
'Emite um aviso com uma mensagem composta pela concatenação de todos os seus argumentos (que devem ser strings).'
|
|||
|
|
|
|||
|
|
xpcall['=5.1'] =
|
|||
|
|
'Faz chamada a função `f` com os argumentos dados e em modo protegido, usando um manipulador de mensagens dado.'
|
|||
|
|
xpcall['>5.2'] =
|
|||
|
|
'Faz chamada a função `f` com os argumentos dados e em modo protegido, usando um manipulador de mensagens dado.'
|
|||
|
|
|
|||
|
|
unpack =
|
|||
|
|
[[
|
|||
|
|
Retorna os elementos da lista dada. Esta função é equivalente a
|
|||
|
|
```lua
|
|||
|
|
return list[i], list[i+1], ···, list[j]
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
bit32 =
|
|||
|
|
''
|
|||
|
|
bit32.arshift =
|
|||
|
|
[[
|
|||
|
|
Retorna o número `x` deslocado `disp` bits para a direita. Deslocamentos negativos movem os bits para a esquerda.
|
|||
|
|
|
|||
|
|
Esta operação de deslocamento é chamada de deslocamento aritmético. Os bits vagos à esquerda são preenchidos com cópias do bit mais significativo de `x`; os bits vagos à direita são preenchidos com zeros.
|
|||
|
|
]]
|
|||
|
|
bit32.band =
|
|||
|
|
'Retorna a operação bitwise *and* de seus operandos.'
|
|||
|
|
bit32.bnot =
|
|||
|
|
[[
|
|||
|
|
Retorna a negação da operação bitwise de `x`.
|
|||
|
|
|
|||
|
|
```lua
|
|||
|
|
assert(bit32.bnot(x) ==
|
|||
|
|
(-1 - x) % 2^32)
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
bit32.bor =
|
|||
|
|
'Retorna a operação bitwise *or* de seus operandos.'
|
|||
|
|
bit32.btest =
|
|||
|
|
'Retorna um valor booleano verdadeiro se a operação bitwise *and* de seus operandos for diferente de zero. Falso, caso contrário.'
|
|||
|
|
bit32.bxor =
|
|||
|
|
'Retorna a operação bitwise *exclusive or* de seus operandos.'
|
|||
|
|
bit32.extract =
|
|||
|
|
'Retorna o número formado pelos bits de `field` a `field + width - 1` de `n`, sem sinal.'
|
|||
|
|
bit32.replace =
|
|||
|
|
'Retorna uma cópia de `n` com os bits de `field` a `field + width - 1` substituídos pelo valor `v` .'
|
|||
|
|
bit32.lrotate =
|
|||
|
|
'Retorna o número `x` rotacionado `disp` bits para a esquerda. Rotações negativos movem os bits para a direita. '
|
|||
|
|
bit32.lshift =
|
|||
|
|
[[
|
|||
|
|
Retorna o número `x` deslocado `disp` bits para a esquerda. Deslocamentos negativos movem os bits para a direita. Em ambas as direções, os bits vazios/vagos são preenchidos com zeros.
|
|||
|
|
|
|||
|
|
```lua
|
|||
|
|
assert(bit32.lshift(b, disp) ==
|
|||
|
|
(b * 2^disp) % 2^32)
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
bit32.rrotate =
|
|||
|
|
'Retorna o número `x` rotacionado `disp` bits para a direita. Deslocamentos negativos movem os bits para a esquerda.'
|
|||
|
|
bit32.rshift =
|
|||
|
|
[[
|
|||
|
|
Retorna o número `x` deslocado `disp` bits para a direita. Deslocamentos negativos movem os bits para a esquerda. Em ambas as direções, os bits vazios são preenchidos com zeros.
|
|||
|
|
|
|||
|
|
```lua
|
|||
|
|
assert(bit32.rshift(b, disp) ==
|
|||
|
|
math.floor(b % 2^32 / 2^disp))
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
coroutine =
|
|||
|
|
''
|
|||
|
|
coroutine.create =
|
|||
|
|
'Cria uma nova `coroutine`, a partir de uma função `f` e retorna esta coroutine como objeto do tipo `"thread"`.'
|
|||
|
|
coroutine.isyieldable =
|
|||
|
|
'Retorna verdadeiro quando a `coroutine` em execução for finalizada.'
|
|||
|
|
coroutine.isyieldable['>5.4']=
|
|||
|
|
'Retorna verdadeiro quando a `coroutine` `co` for finalizada. Por padrão `co` é uma coroutine em execução.'
|
|||
|
|
coroutine.close =
|
|||
|
|
'Finaliza a coroutine `co` , encerrando todas as variáveis pendentes e colocando a coroutine em um estado morto.'
|
|||
|
|
coroutine.resume =
|
|||
|
|
'Inicia ou continua a execução da coroutine `co`.'
|
|||
|
|
coroutine.running =
|
|||
|
|
'Retorna a `coroutine` corrente e um booleana verdadeiro quando a coroutine corrente é a principal.'
|
|||
|
|
coroutine.status =
|
|||
|
|
'Retorna o status da `coroutine `co`.'
|
|||
|
|
coroutine.wrap =
|
|||
|
|
'Cria uma nova `coroutine`, a partir de uma função `f` e retorna uma função que retorna a coroutine cada vez que ele é chamado.'
|
|||
|
|
coroutine.yield =
|
|||
|
|
'Suspende a execução da coroutine chamada.'
|
|||
|
|
|
|||
|
|
costatus.running =
|
|||
|
|
'Está em execução.'
|
|||
|
|
costatus.suspended =
|
|||
|
|
'Está suspenso ou não foi iniciado.'
|
|||
|
|
costatus.normal =
|
|||
|
|
'Está ativo, mas não está em execução.'
|
|||
|
|
costatus.dead =
|
|||
|
|
'Terminou ou parou devido a erro'
|
|||
|
|
|
|||
|
|
debug =
|
|||
|
|
''
|
|||
|
|
debug.debug =
|
|||
|
|
'Entra em modo interativo com o usuário, executando os comandos de entrada.'
|
|||
|
|
debug.getfenv =
|
|||
|
|
'Retorna o ambiente do objeto `o` .'
|
|||
|
|
debug.gethook =
|
|||
|
|
'Retorna as configurações do `hook` atual da `thread`.'
|
|||
|
|
debug.getinfo =
|
|||
|
|
'Retorna uma tabela com informações sobre uma função.'
|
|||
|
|
debug.getlocal['<5.1'] =
|
|||
|
|
'Retorna o nome e o valor da variável local com índice `local` da função de nível `level` da pilha.'
|
|||
|
|
debug.getlocal['>5.2'] =
|
|||
|
|
'Retorna o nome e o valor da variável local com índice `local` da função de nível `f` da pilha.'
|
|||
|
|
debug.getmetatable =
|
|||
|
|
'Retorna a `metatable` do valor dado.'
|
|||
|
|
debug.getregistry =
|
|||
|
|
'Retorna a tabela de registro.'
|
|||
|
|
debug.getupvalue =
|
|||
|
|
'Retorna o nome e o valor da variável antecedente com índice `up` da função.'
|
|||
|
|
debug.getuservalue['<5.3'] =
|
|||
|
|
'Retorna o valor de Lua associado a `u` (i.e., user).'
|
|||
|
|
debug.getuservalue['>5.4'] =
|
|||
|
|
[[
|
|||
|
|
Retorna o `n`-ésimo valor de usuário associado
|
|||
|
|
aos dados do usuário `u` e um booleano,
|
|||
|
|
`false`, se nos dados do usuário não existir esse valor.
|
|||
|
|
]]
|
|||
|
|
debug.setcstacklimit =
|
|||
|
|
[[
|
|||
|
|
### **Deprecated in `Lua 5.4.2`**
|
|||
|
|
|
|||
|
|
Estabelece um novo limite para a pilha C. Este limite controla quão profundamente as chamadas aninhadas podem ir em Lua, com a intenção de evitar um transbordamento da pilha.
|
|||
|
|
|
|||
|
|
Em caso de sucesso, esta função retorna o antigo limite. Em caso de erro, ela retorna `false`.
|
|||
|
|
]]
|
|||
|
|
debug.setfenv =
|
|||
|
|
'Define o ambiente do `object` dado para a `table` dada .'
|
|||
|
|
debug.sethook =
|
|||
|
|
'Define a função dada como um `hook`.'
|
|||
|
|
debug.setlocal =
|
|||
|
|
'Atribui o valor `value` à variável local com índice `local` da função de nível `level` da pilha.'
|
|||
|
|
debug.setmetatable =
|
|||
|
|
'Define a `metatable` com o valor dado para tabela dada (que pode ser `nil`).'
|
|||
|
|
debug.setupvalue =
|
|||
|
|
'Atribui `value` a variável antecedente com índice `up` da função.'
|
|||
|
|
debug.setuservalue['<5.3'] =
|
|||
|
|
'Define o valor dado como o valor Lua associado ao `udata` (i.e., user data).'
|
|||
|
|
debug.setuservalue['>5.4'] =
|
|||
|
|
[[
|
|||
|
|
Define o valor dado como
|
|||
|
|
o `n`-ésimo valor de usuário associado ao `udata` (i.e., user data).
|
|||
|
|
O `udata` deve ser um dado de usuário completo.
|
|||
|
|
]]
|
|||
|
|
debug.traceback =
|
|||
|
|
'Retorna uma string com um `traceback` de chamadas. A string de mensagen (opcional) é anexada no início do traceback.'
|
|||
|
|
debug.upvalueid =
|
|||
|
|
'Retorna um identificador único (como um dado de usuário leve) para o valor antecedente de numero `n` da função dada.'
|
|||
|
|
debug.upvaluejoin =
|
|||
|
|
'Faz o `n1`-ésimo valor da função `f1` (i.e., closure Lua) referir-se ao `n2`-ésimo valor da função `f2`.'
|
|||
|
|
|
|||
|
|
infowhat.n =
|
|||
|
|
'`name` e `namewhat`'
|
|||
|
|
infowhat.S =
|
|||
|
|
'`source`, `short_src`, `linedefined`, `lastlinedefined` e `what`'
|
|||
|
|
infowhat.l =
|
|||
|
|
'`currentline`'
|
|||
|
|
infowhat.t =
|
|||
|
|
'`istailcall`'
|
|||
|
|
infowhat.u['<5.1'] =
|
|||
|
|
'`nups`'
|
|||
|
|
infowhat.u['>5.2'] =
|
|||
|
|
'`nups`, `nparams` e `isvararg`'
|
|||
|
|
infowhat.f =
|
|||
|
|
'`func`'
|
|||
|
|
infowhat.r =
|
|||
|
|
'`ftransfer` e `ntransfer`'
|
|||
|
|
infowhat.L =
|
|||
|
|
'`activelines`'
|
|||
|
|
|
|||
|
|
hookmask.c =
|
|||
|
|
'Faz chamada a um `hook` quando o Lua chama uma função.'
|
|||
|
|
hookmask.r =
|
|||
|
|
'Faz chamada a um `hook` quando o retorno de uma função é executado.'
|
|||
|
|
hookmask.l =
|
|||
|
|
'Faz chamada a um `hook` quando encontra nova linha de código.'
|
|||
|
|
|
|||
|
|
file =
|
|||
|
|
''
|
|||
|
|
file[':close'] =
|
|||
|
|
'Fecha o arquivo `file`.'
|
|||
|
|
file[':flush'] =
|
|||
|
|
'Salva qualquer dado de entrada no arquivo `file`.'
|
|||
|
|
file[':lines'] =
|
|||
|
|
[[
|
|||
|
|
------
|
|||
|
|
```lua
|
|||
|
|
for c in file:lines(...) do
|
|||
|
|
body
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
file[':read'] =
|
|||
|
|
'Lê o arquivo de acordo com o formato fornecido e que especifica o que deve ser lido.'
|
|||
|
|
file[':seek'] =
|
|||
|
|
'Define e obtém a posição do arquivo, medida a partir do início do arquivo.'
|
|||
|
|
file[':setvbuf'] =
|
|||
|
|
'Define o modo de `buffer` para um arquivo de saída.'
|
|||
|
|
file[':write'] =
|
|||
|
|
'Escreve o valor de cada um de seus argumentos no arquivo.'
|
|||
|
|
|
|||
|
|
readmode.n =
|
|||
|
|
'Lê um numeral e o devolve como número.'
|
|||
|
|
readmode.a =
|
|||
|
|
'Lê o arquivo completo.'
|
|||
|
|
readmode.l =
|
|||
|
|
'Lê a próxima linha pulando o final da linha.'
|
|||
|
|
readmode.L =
|
|||
|
|
'Lê a próxima linha mantendo o final da linha.'
|
|||
|
|
|
|||
|
|
seekwhence.set =
|
|||
|
|
'O cursor base é o início do arquivo.'
|
|||
|
|
seekwhence.cur =
|
|||
|
|
'O cursor base é a posição atual.'
|
|||
|
|
seekwhence['.end'] =
|
|||
|
|
'O cursor base é o final do arquivo.'
|
|||
|
|
|
|||
|
|
vbuf.no =
|
|||
|
|
'A saída da operação aparece imediatamente.'
|
|||
|
|
vbuf.full =
|
|||
|
|
'Realizado apenas quando o `buffer` está cheio.'
|
|||
|
|
vbuf.line =
|
|||
|
|
'`Buffered` até que uma nova linha seja encontrada.'
|
|||
|
|
|
|||
|
|
io =
|
|||
|
|
''
|
|||
|
|
io.stdin =
|
|||
|
|
'Entrada padrão.'
|
|||
|
|
io.stdout =
|
|||
|
|
'Saída padrão.'
|
|||
|
|
io.stderr =
|
|||
|
|
'Erro padrão.'
|
|||
|
|
io.close =
|
|||
|
|
'Fecha o arquivo dado ou o arquivo de saída padrão.'
|
|||
|
|
io.flush =
|
|||
|
|
'Salva todos os dados gravados no arquivo de saída padrão.'
|
|||
|
|
io.input =
|
|||
|
|
'Define o arquivo de entrada padrão.'
|
|||
|
|
io.lines =
|
|||
|
|
[[
|
|||
|
|
------
|
|||
|
|
```lua
|
|||
|
|
for c in io.lines(filename, ...) do
|
|||
|
|
body
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
io.open =
|
|||
|
|
'Abre um arquivo no modo especificado pela *string* `mode`.'
|
|||
|
|
io.output =
|
|||
|
|
'Define o arquivo de saída padrão.'
|
|||
|
|
io.popen =
|
|||
|
|
'Inicia o programa dado em um processo separado.'
|
|||
|
|
io.read =
|
|||
|
|
'Lê o arquivo de acordo com o formato fornecido e que especifica o que deve ser lido.'
|
|||
|
|
io.tmpfile =
|
|||
|
|
'Em caso de sucesso, retorna um `handler` para um arquivo temporário.'
|
|||
|
|
io.type =
|
|||
|
|
'Verifica se `obj` é um identificador de arquivo válido.'
|
|||
|
|
io.write =
|
|||
|
|
'Escreve o valor de cada um dos seus argumentos para o arquivo de saída padrão.'
|
|||
|
|
|
|||
|
|
openmode.r =
|
|||
|
|
'Modo de leitura.'
|
|||
|
|
openmode.w =
|
|||
|
|
'Modo de escrita.'
|
|||
|
|
openmode.a =
|
|||
|
|
'Modo de anexação.'
|
|||
|
|
openmode['.r+'] =
|
|||
|
|
'Modo de atualização, todos os dados anteriores são preservados.'
|
|||
|
|
openmode['.w+'] =
|
|||
|
|
'Modo de atualização, todos os dados anteriores são apagados.'
|
|||
|
|
openmode['.a+'] =
|
|||
|
|
'Modo de anexação e atualização, os dados anteriores são preservados, a escrita só é permitida no final do arquivo.'
|
|||
|
|
openmode.rb =
|
|||
|
|
'Modo de leitura. (em modo binário)'
|
|||
|
|
openmode.wb =
|
|||
|
|
'Modo de escrita. (em modo binário)'
|
|||
|
|
openmode.ab =
|
|||
|
|
'Modo de anexação. (em modo binário)'
|
|||
|
|
openmode['.r+b'] =
|
|||
|
|
'Modo de atualização, todos os dados anteriores são preservados. (em modo binário)'
|
|||
|
|
openmode['.w+b'] =
|
|||
|
|
'Modo de atualização, todos os dados anteriores são apagados. (em modo binário)'
|
|||
|
|
openmode['.a+b'] =
|
|||
|
|
'Modo de anexação e atualização, todos os dados anteriores são preservados, a escrita só é permitida no final do arquivo. (em modo binário)'
|
|||
|
|
|
|||
|
|
popenmode.r =
|
|||
|
|
'Leia dados deste programa pelo arquivo.'
|
|||
|
|
popenmode.w =
|
|||
|
|
'Escreva dados neste programa pelo arquivo.'
|
|||
|
|
|
|||
|
|
filetype.file =
|
|||
|
|
'`handler` para arquivo aberto.'
|
|||
|
|
filetype['.closed file'] =
|
|||
|
|
'`handler` para arquivo fechado.'
|
|||
|
|
filetype['.nil'] =
|
|||
|
|
'Não é um `handler` de arquivo'
|
|||
|
|
|
|||
|
|
math =
|
|||
|
|
''
|
|||
|
|
math.abs =
|
|||
|
|
'Retorna o valor absoluto de `x`.'
|
|||
|
|
math.acos =
|
|||
|
|
'Retorna o arco cosseno de `x` (em radianos).'
|
|||
|
|
math.asin =
|
|||
|
|
'Retorna o arco seno de `x` (em radianos).'
|
|||
|
|
math.atan['<5.2'] =
|
|||
|
|
'Retorna o arco tangente de `x` (em radianos).'
|
|||
|
|
math.atan['>5.3'] =
|
|||
|
|
'Retorna o arco tangente de `y/x` (em radianos).'
|
|||
|
|
math.atan2 =
|
|||
|
|
'Retorna o arco tangente de `y/x` (em radianos).'
|
|||
|
|
math.ceil =
|
|||
|
|
'Retorna o menor valor inteiro maior ou igual a `x`.'
|
|||
|
|
math.cos =
|
|||
|
|
'Retorna o cosseno de `x` (requer valor em radianos).'
|
|||
|
|
math.cosh =
|
|||
|
|
'Retorna o cosseno hiperbólico de `x` (requer valor em radianos).'
|
|||
|
|
math.deg =
|
|||
|
|
'Converte o ângulo `x` de radianos para graus.'
|
|||
|
|
math.exp =
|
|||
|
|
'Retorna o valor `e^x` (onde `e` é a base do logaritmo natural).'
|
|||
|
|
math.floor =
|
|||
|
|
'Retorna o maior valor inteiro menor ou igual a `x`.'
|
|||
|
|
math.fmod =
|
|||
|
|
'Retorna o resto da divisão de `x` por `y` que arredonda o quociente para zero.'
|
|||
|
|
math.frexp =
|
|||
|
|
'Decompõe `x` em fatores e expoentes. Retorna `m` e `e` tal que `x = m * (2 ^ e)` é um inteiro e o valor absoluto de `m` está no intervalo [0,5, 1) (ou zero quando `x` é zero).'
|
|||
|
|
math.huge =
|
|||
|
|
'Um valor maior que qualquer outro valor numérico.'
|
|||
|
|
math.ldexp =
|
|||
|
|
'Retorna `m * (2 ^ e)`.'
|
|||
|
|
math.log['<5.1'] =
|
|||
|
|
'Retorna o logaritmo natural de `x`.'
|
|||
|
|
math.log['>5.2'] =
|
|||
|
|
'Retorna o logaritmo de `x` na base dada.'
|
|||
|
|
math.log10 =
|
|||
|
|
'Retorna o logaritmo `x` na base 10.'
|
|||
|
|
math.max =
|
|||
|
|
'Retorna o argumento com o valor máximo de acordo com o operador `<`.'
|
|||
|
|
math.maxinteger =
|
|||
|
|
'Retorna o valor máximo para um inteiro.'
|
|||
|
|
math.min =
|
|||
|
|
'Retorna o argumento com o valor mínimo de acordo com o operador `<`.'
|
|||
|
|
math.mininteger =
|
|||
|
|
'Retorna o valor mínimo para um inteiro.'
|
|||
|
|
math.modf =
|
|||
|
|
'Retorna a parte inteira e a parte fracionária de `x`.'
|
|||
|
|
math.pi =
|
|||
|
|
'O valor de *π*.'
|
|||
|
|
math.pow =
|
|||
|
|
'Retorna `x ^ y`.'
|
|||
|
|
math.rad =
|
|||
|
|
'Converte o ângulo `x` de graus para radianos.'
|
|||
|
|
math.random =
|
|||
|
|
[[
|
|||
|
|
* `math.random()`: Retorna um valor real (i.e., ponto flutuante) no intervalo [0,1).
|
|||
|
|
* `math.random(n)`: Retorna um inteiro no intervalo [1, n].
|
|||
|
|
* `math.random(m, n)`: Retorna um inteiro no intervalo [m, n].
|
|||
|
|
]]
|
|||
|
|
math.randomseed['<5.3'] =
|
|||
|
|
'Define `x` como valor semente (i.e., `seed`) para a função geradora de números pseudo-aleatória.'
|
|||
|
|
math.randomseed['>5.4'] =
|
|||
|
|
[[
|
|||
|
|
* `math.randomseed(x, y)`: Concatena `x` e `y` em um espaço de 128-bits que é usado como valor semente (`seed`) para reinicializar o gerador de números pseudo-aleatório.
|
|||
|
|
* `math.randomseed(x)`: Equivale a `math.randomseed(x, 0)` .
|
|||
|
|
* `math.randomseed()`: Gera um valor semente (i.e., `seed`) com fraca probabilidade de aleatoriedade.
|
|||
|
|
]]
|
|||
|
|
math.sin =
|
|||
|
|
'Retorna o seno de `x` (requer valor em radianos).'
|
|||
|
|
math.sinh =
|
|||
|
|
'Retorna o seno hiperbólico de `x` (requer valor em radianos).'
|
|||
|
|
math.sqrt =
|
|||
|
|
'Retorna a raiz quadrada de `x`.'
|
|||
|
|
math.tan =
|
|||
|
|
'Retorna a tangente de `x` (requer valor em radianos).'
|
|||
|
|
math.tanh =
|
|||
|
|
'Retorna a tangente hiperbólica de `x` (requer valor em radianos).'
|
|||
|
|
math.tointeger =
|
|||
|
|
'Se o valor `x` pode ser convertido para um inteiro, retorna esse inteiro.'
|
|||
|
|
math.type =
|
|||
|
|
'Retorna `"integer"` se `x` é um inteiro, `"float"` se for um valor real (i.e., ponto flutuante), ou `nil` se `x` não é um número.'
|
|||
|
|
math.ult =
|
|||
|
|
'Retorna `true` se e somente se `m` é menor `n` quando eles são comparados como inteiros sem sinal.'
|
|||
|
|
|
|||
|
|
os =
|
|||
|
|
''
|
|||
|
|
os.clock =
|
|||
|
|
'Retorna uma aproximação do valor, em segundos, do tempo de CPU usado pelo programa.'
|
|||
|
|
os.date =
|
|||
|
|
'Retorna uma string ou uma tabela contendo data e hora, formatada de acordo com a string `format` fornecida.'
|
|||
|
|
os.difftime =
|
|||
|
|
'Retorna a diferença, em segundos, do tempo `t1` para o tempo` t2`.'
|
|||
|
|
os.execute =
|
|||
|
|
'Passa `command` para ser executado por um `shell` do sistema operacional.'
|
|||
|
|
os.exit['<5.1'] =
|
|||
|
|
'Chama a função `exit` do C para encerrar o programa.'
|
|||
|
|
os.exit['>5.2'] =
|
|||
|
|
'Chama a função `exit` do ISO C para encerrar o programa.'
|
|||
|
|
os.getenv =
|
|||
|
|
'Retorna o valor da variável de ambiente de processo `varname`.'
|
|||
|
|
os.remove =
|
|||
|
|
'Remove o arquivo com o nome dado.'
|
|||
|
|
os.rename =
|
|||
|
|
'Renomeia o arquivo ou diretório chamado `oldname` para `newname`.'
|
|||
|
|
os.setlocale =
|
|||
|
|
'Define a localidade atual do programa.'
|
|||
|
|
os.time =
|
|||
|
|
'Retorna a hora atual quando chamada sem argumentos, ou um valor representando a data e a hora local especificados pela tabela fornecida.'
|
|||
|
|
os.tmpname =
|
|||
|
|
'Retorna uma string com um nome de arquivo que pode ser usado como arquivo temporário.'
|
|||
|
|
|
|||
|
|
osdate.year =
|
|||
|
|
'Quatro dígitos.'
|
|||
|
|
osdate.month =
|
|||
|
|
'1-12'
|
|||
|
|
osdate.day =
|
|||
|
|
'1-31'
|
|||
|
|
osdate.hour =
|
|||
|
|
'0-23'
|
|||
|
|
osdate.min =
|
|||
|
|
'0-59'
|
|||
|
|
osdate.sec =
|
|||
|
|
'0-61'
|
|||
|
|
osdate.wday =
|
|||
|
|
'Dia da semana, 1–7, Domingo é 1'
|
|||
|
|
osdate.yday =
|
|||
|
|
'Dia do ano, 1–366'
|
|||
|
|
osdate.isdst =
|
|||
|
|
'Bandeira para indicar horário de verão (i.e., `Daylight Saving Time`), um valor booleano.'
|
|||
|
|
|
|||
|
|
package =
|
|||
|
|
''
|
|||
|
|
|
|||
|
|
require['<5.3'] =
|
|||
|
|
'Carrega o módulo fornecido e retorna qualquer valor retornado pelo módulo (`true` quando `nil`).'
|
|||
|
|
require['>5.4'] =
|
|||
|
|
'Carrega o módulo fornecido e retorna qualquer valor retornado pelo pesquisador (`true` quando `nil`). Além desse valor, também retorna como segundo resultado um carregador de dados retornados pelo pesquisador, o que indica como `require` encontrou o módulo. (Por exemplo, se o módulo vier de um arquivo, este carregador de dados é o caminho do arquivo.)'
|
|||
|
|
|
|||
|
|
package.config =
|
|||
|
|
'string descrevendo configurações a serem utilizadas durante a compilação de pacotes.'
|
|||
|
|
package.cpath =
|
|||
|
|
'O caminho usado pelo `require` para procurar pelo carregador C.'
|
|||
|
|
package.loaded =
|
|||
|
|
'Uma tabela usada pelo `require` para controlar quais módulos já estão carregados.'
|
|||
|
|
package.loaders =
|
|||
|
|
'Uma tabela usada pelo `require` para controlar como carregar módulos.'
|
|||
|
|
package.loadlib =
|
|||
|
|
'Dinamicamente vincula o programa no `host` com a biblioteca C `libname`.'
|
|||
|
|
package.path =
|
|||
|
|
'O caminho usado pelo `require` para procurar por um carregador Lua.'
|
|||
|
|
package.preload =
|
|||
|
|
'Uma tabela para armazenar carregadores de módulos específicos.'
|
|||
|
|
package.searchers =
|
|||
|
|
'Uma tabela usada pelo `require` para controlar como buscar módulos.'
|
|||
|
|
package.searchpath =
|
|||
|
|
'Procura por `name` em `path`.'
|
|||
|
|
package.seeall =
|
|||
|
|
'Define uma `metatable` `module` com o campo `__index` referenciando o ambiente global, para que este módulo herde valores do ambiente global. Para ser usado como uma opção a função `module`.'
|
|||
|
|
|
|||
|
|
string =
|
|||
|
|
''
|
|||
|
|
string.byte =
|
|||
|
|
'Retorna os códigos numéricos internos dos caracteres `s[i], s[i+1], ..., s[j]`.'
|
|||
|
|
string.char =
|
|||
|
|
'Retorna uma string com comprimento igual ao número de argumentos, no qual cada caractere possui o código numérico interno igual ao seu argumento correspondente.'
|
|||
|
|
string.dump =
|
|||
|
|
'Retorna uma string contendo uma representação binária (i.e., *binary chunk*) da função dada.'
|
|||
|
|
string.find =
|
|||
|
|
'Procura a primeira correspondencia de `pattern` (veja §6.4.1) na string.'
|
|||
|
|
string.format =
|
|||
|
|
'Retorna uma versão formatada de seu número variável de argumentos após a descrição dada em seu primeiro argumento.'
|
|||
|
|
string.gmatch =
|
|||
|
|
[[
|
|||
|
|
Retorna um iterator que, a cada vez que é chamado, retorna as próximas capturas de `pattern` (veja §6.4.1) sobre a string *s*.
|
|||
|
|
|
|||
|
|
Por exemplo, o loop a seguir irá iterar em todas as palavras da string *s*, imprimindo cada palavra por linha:
|
|||
|
|
```lua
|
|||
|
|
s =
|
|||
|
|
"hello world from Lua"
|
|||
|
|
for w in string.gmatch(s, "%a+") do
|
|||
|
|
print(w)
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
string.gsub =
|
|||
|
|
'Retorna uma cópia da *s* em que todas ou, caso fornecido, as primeiras `n` ocorrências de `pattern` (veja §6.4.1) que tiverem sido substituídas por uma string de substituição especificada por `repl`.'
|
|||
|
|
string.len =
|
|||
|
|
'Retorna o comprimento da string.'
|
|||
|
|
string.lower =
|
|||
|
|
'Retorna uma cópia desta string com todas as letras maiúsculas alteradas para minúsculas.'
|
|||
|
|
string.match =
|
|||
|
|
'Procura a primeira ocorrência do `pattern` (veja §6.4.1) na string.'
|
|||
|
|
string.pack =
|
|||
|
|
'Retorna uma string binária contendo os valores `V1`, `v2`, etc. empacotados (isto é, serializado de forma binário) de acordo com o formato da string `fmt` fornecida (veja §6.4.2).'
|
|||
|
|
string.packsize =
|
|||
|
|
'Retorna o tamanho de uma string resultante de `string.pack` com o formato da string `fmt` fornecida (veja §6.4.2).'
|
|||
|
|
string.rep['>5.2'] =
|
|||
|
|
'Retorna uma string que é a concatenação de `n` cópias da string `s` separadas pela string `sep`.'
|
|||
|
|
string.rep['<5.1'] =
|
|||
|
|
'Retorna uma string que é a concatenação de `n` cópias da string `s`.'
|
|||
|
|
string.reverse =
|
|||
|
|
'Retorna uma string que representa a string `s` invertida.'
|
|||
|
|
string.sub =
|
|||
|
|
'Retorna a substring da string `s` que começa no índice `i` e continua até o índice `j`.'
|
|||
|
|
string.unpack =
|
|||
|
|
'Retorna os valores empacotados na string de acordo com o formato da string `fmt` fornecida (veja §6.4.2).'
|
|||
|
|
string.upper =
|
|||
|
|
'Retorna uma cópia desta string com todas as letras minúsculas alteradas para maiúsculas.'
|
|||
|
|
|
|||
|
|
table =
|
|||
|
|
''
|
|||
|
|
table.concat =
|
|||
|
|
'Dada uma lista onde todos os elementos são strings ou números, retorna a string `list[i]..sep..list[i+1] ··· sep..list[j]`.'
|
|||
|
|
table.insert =
|
|||
|
|
'Insere o elemento `value` na posição `pos` de `list`.'
|
|||
|
|
table.maxn =
|
|||
|
|
'Retorna o maior índice numérico positivo da tabela fornecida ou zero se a tabela não tiver índices numéricos positivos.'
|
|||
|
|
table.move =
|
|||
|
|
[[
|
|||
|
|
Move os elementos da tabela `a1` para tabela `a2`.
|
|||
|
|
```lua
|
|||
|
|
a2[t],··· =
|
|||
|
|
a1[f],···,a1[e]
|
|||
|
|
return a2
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
table.pack =
|
|||
|
|
'Retorna uma nova tabela com todos os argumentos armazenados em chaves `1`, `2`, etc. e com um campo `"n"` com o número total de argumentos.'
|
|||
|
|
table.remove =
|
|||
|
|
'Remove de `list` o elemento na posição `pos`, retornando o valor do elemento removido.'
|
|||
|
|
table.sort =
|
|||
|
|
'Ordena os elementos de `list` em uma determinada ordem, *in-place*, de `list[1]` para `list[#list]`.'
|
|||
|
|
table.unpack =
|
|||
|
|
[[
|
|||
|
|
Retorna os elementos da lista fornecida. Esta função é equivalente a
|
|||
|
|
```lua
|
|||
|
|
return list[i], list[i+1], ···, list[j]
|
|||
|
|
```
|
|||
|
|
Por padrão, `i` é `1` e `j` é `#list`.
|
|||
|
|
]]
|
|||
|
|
table.foreach = -- TODO: need translate!
|
|||
|
|
'Executes the given f over all elements of table. For each element, f is called with the index and respective value as arguments. If f returns a non-nil value, then the loop is broken, and this value is returned as the final value of foreach.'
|
|||
|
|
table.foreachi = -- TODO: need translate!
|
|||
|
|
'Executes the given f over the numerical indices of table. For each index, f is called with the index and respective value as arguments. Indices are visited in sequential order, from 1 to n, where n is the size of the table. If f returns a non-nil value, then the loop is broken and this value is returned as the result of foreachi.'
|
|||
|
|
table.getn = -- TODO: need translate!
|
|||
|
|
'Returns the number of elements in the table. This function is equivalent to `#list`.'
|
|||
|
|
table.new = -- TODO: need translate!
|
|||
|
|
[[This creates a pre-sized table, just like the C API equivalent `lua_createtable()`. This is useful for big tables if the final table size is known and automatic table resizing is too expensive. `narray` parameter specifies the number of array-like items, and `nhash` parameter specifies the number of hash-like items. The function needs to be required before use.
|
|||
|
|
```lua
|
|||
|
|
require("table.new")
|
|||
|
|
```
|
|||
|
|
]]
|
|||
|
|
table.clear = -- TODO: need translate!
|
|||
|
|
[[This clears all keys and values from a table, but preserves the allocated array/hash sizes. This is useful when a table, which is linked from multiple places, needs to be cleared and/or when recycling a table for use by the same context. This avoids managing backlinks, saves an allocation and the overhead of incremental array/hash part growth. The function needs to be required before use.
|
|||
|
|
```lua
|
|||
|
|
require("table.clear").
|
|||
|
|
```
|
|||
|
|
Please note this function is meant for very specific situations. In most cases it's better to replace the (usually single) link with a new table and let the GC do its work.
|
|||
|
|
]]
|
|||
|
|
|
|||
|
|
utf8 =
|
|||
|
|
''
|
|||
|
|
utf8.char =
|
|||
|
|
'Recebe zero ou mais inteiros, converte cada um à sua sequência de byte UTF-8 correspondente e retorna uma string com a concatenação de todas essas sequências.'
|
|||
|
|
utf8.charpattern =
|
|||
|
|
'O padrão que corresponde exatamente uma sequência de byte UTF-8, supondo que seja uma sequência válida UTF-8.'
|
|||
|
|
utf8.codes =
|
|||
|
|
[[
|
|||
|
|
Retorna valores tal que a seguinte construção
|
|||
|
|
```lua
|
|||
|
|
for p, c in utf8.codes(s) do
|
|||
|
|
body
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
itere em todos os caracteres UTF-8 na string s, com p sendo a posição (em bytes) e c o *codepoint* de cada caractere. Ele gera um erro se encontrado qualquer sequência de byte inválida.
|
|||
|
|
]]
|
|||
|
|
utf8.codepoint =
|
|||
|
|
'Retorna os *codepoints* (em inteiros) de todos os caracteres em `s` que iniciam entre as posições do byte `i` e `j` (ambos inclusos).'
|
|||
|
|
utf8.len =
|
|||
|
|
'Retorna o número de caracteres UTF-8 na string `s` que começa entre as posições `i` e `j` (ambos inclusos).'
|
|||
|
|
utf8.offset =
|
|||
|
|
'Retorna a posição (em bytes) onde a codificação do `n`-ésimo caractere de `s` inícia (contando a partir da posição `i`).'
|