📚 Biblioteca Padrão

Documentação completa de todas as funções e bibliotecas nativas da linguagem Sol.

🌐 Global (Base) ➗ Matemática 📘 Texto 📊 Tabela 🖥️ Terminal ⚙️ Sistema Operacional 🧶 Corrotina 📦 Pacote 🔤 UTF-8 🐞 Depuração ☑️ Filamento ⚡ Paralelismo 🧪 Teste 📄 NDS

🌐 Biblioteca Global (Base)

funções básicas disponíveis globalmente em qualquer script.

afirme (condição, [mensagem])

Verifica se uma condição é verdadeira. Se for falsa, lança um erro com a mensagem fornecida.

Parâmetros

condição: Qualquer - A expressão a ser testada.
mensagem: Texto (opcional) - Mensagem de erro caso a condição falhe.

Exemplo

afirme(10 > 5, "Erro impossível") -- Passa
afirme(falso, "Isso vai parar o programa") -- Erro

avise (mensagem)

Emite um aviso no console sem interromper o programa.

Parâmetros

mensagem: Texto - O aviso a ser exibido.

Exemplo

avise("Isso é apenas um aviso.")

carregue (código, [nome_chunk])

Carrega um trecho de código Sol (string) e retorna como função.

Parâmetros

código: Texto - O código fonte a ser compilado.
nome_chunk: Texto (opcional) - Nome para mensagens de erro.

Retorno

Função (se sucesso) ou nulo e mensagem de erro.

Exemplo

local f = carregue("retorne 10 + 20")
exiba(f()) -- 30

carregue_arquivo (caminho)

Carrega um arquivo Sol e retorna seu conteúdo como uma função executável.

Parâmetros

caminho: Texto - Caminho para o arquivo.

Retorno

Função (se sucesso) ou nulo e mensagem de erro.

Exemplo

local script = carregue_arquivo("meu_script.sol")
script() -- Executa o arquivo

chame_protegido (função, [args...])

Executa uma função em modo protegido (pcall). Se houver erro, retorna falso e a mensagem.

Parâmetros

função: Função - A função a ser chamada.
args: Variável - Argumentos para a função.

Retorno

Lógico (sucesso/falha) e resultados da função ou mensagem de erro.

Exemplo

local ok, erro = chame_protegido(function() error("Boom!") end)
se não ok então exiba("Erro capturado:", erro) fim

colete_lixo ([opção], [arg])

Interage com o Coletor de Lixo (Garbage Collector).

Parâmetros

opção: Texto - "collect", "count", "stop", "restart".

Exemplo

colete_lixo("collect") -- Força uma coleta completa

converta_para_número (valor, [base])

Tenta converter o valor para número.

Parâmetros

valor: Texto/Número - Valor a converter.
base: Inteiro (opcional) - Base numérica (2-36). Padrão 10.

Retorno

Número ou nulo se falhar.

Exemplo

local n = converta_para_número("123") -- 123
local hex = converta_para_número("FF", 16) -- 255

converta_para_texto (valor)

Converte qualquer valor para sua representação em texto.

Parâmetros

valor: Qualquer - Valor a converter.

Retorno

Texto.

Exemplo

local s = converta_para_texto(123) -- "123"

defina_metatabela (tabela, metatabela)

Define a metatabela de uma tabela.

Parâmetros

tabela: Tabela - A tabela alvo.
metatabela: Tabela/Nulo - A nova metatabela.

Retorno

A própria tabela.

Exemplo

defina_metatabela(obj, {__índice = Classe})

execute_arquivo (caminho)

Carrega e executa um arquivo Sol imediatamente.

Parâmetros

caminho: Texto - Caminho do arquivo.

Exemplo

execute_arquivo("config.sol")

exiba (valores...)

Mostra valores na saída Padrão (console).

Parâmetros

valores: Qualquer - Lista de valores para exibir.

Exemplo

exiba("Olá", "Mundo", 2026)

lance_erro (mensagem, [nível])

Interrompe a execução com uma mensagem de erro.

Parâmetros

mensagem: Texto - A mensagem de erro.
nível: Inteiro (opcional) - Nível da pilha onde ocorreu o erro.

Exemplo

lance_erro("Algo deu errado!")

obtenha_metatabela (valor)

Retorna a metatabela associada ao valor.

Parâmetros

valor: Qualquer - O valor para consultar.

Retorno

Tabela ou nulo.

Exemplo

local meta = obtenha_metatabela(obj)

obtenha_pares (tabela)

Iterador para percorrer todas as chaves e valores de uma tabela.

Parâmetros

tabela: Tabela - A tabela a iterar.

Exemplo

para k, v em obtenha_pares(tab) faça
    exiba(k, v)
fim

obtenha_pares_indexados (tabela)

Iterador para percorrer apenas índices numéricos sequenciais (array).

Parâmetros

tabela: Tabela - A tabela a iterar.

Exemplo

para i, v em obtenha_pares_indexados(lista) faça
    exiba(i, v)
fim

obtenha_tipo (valor)

Retorna o tipo do valor como string ("numero", "texto", "tabela", "funcao", "usuario", "filamento", "nulo").

Parâmetros

valor: Qualquer - O valor a inspecionar.

Retorno

Texto.

Exemplo

exiba(obtenha_tipo(10)) -- "numero"
exiba(obtenha_tipo("Olá")) -- "texto"

selecione (índice, ...)

Retorna todos os argumentos após o índice especificado. Se índice for "#", retorna o número total de argumentos.

Parâmetros

índice: Inteiro/Texto - Posição inicial ou "#".
...: Variável - Argumentos.

Retorno

Múltiplos valores.

Exemplo

selecione(2, "a", "b", "c") -- Retorna "b", "c"
exiba(selecione("#", "a", "b", "c")) -- 3

➗ Matemática (math)

funções Matemáticas. Importe com local mat = importe("matematica").

arredonde_para_piso (x)

Arredonda um número para baixo (floor).

Parâmetros

x: Número - O valor a arredondar.

Retorno

Inteiro.

Exemplo

mat.arredonde_para_piso(3.9) -- 3

arredonde_para_teto (x)

Arredonda um número para cima (ceil).

Parâmetros

x: Número - O valor a arredondar.

Retorno

Inteiro.

Exemplo

mat.arredonde_para_teto(3.1) -- 4

converta_para_graus (rad)

Converte um ângulo de radianos para graus.

Parâmetros

rad: Número - ângulo em radianos.

Retorno

Número (graus).

Exemplo

local g = mat.converta_para_graus(mat.pi) -- 180

converta_para_inteiro (x)

Tenta converter um nÃºmero ou string para um valor inteiro.

Parâmetros

x: NÃºmero/Texto - O valor a converter.

Retorno

Inteiro ou nulo.

Exemplo

local int = mat.converta_para_inteiro(3.0) -- 3

converta_para_radianos (graus)

Converte um Ã¢ngulo de graus para radianos.

Parâmetros

graus: NÃºmero - Ã‚ngulo em graus.

Retorno

NÃºmero (radianos).

Exemplo

local rad = mat.converta_para_radianos(180) -- 3.14159...

defina_semente_aleatÃ³ria (x)

Define a semente (seed) para o gerador de nÃºmeros pseudo-aleatÃ³rios.

ParÃ¢metros

x: Inteiro - A semente.

Exemplo

mat.defina_semente_aleatÃ³ria(os.tempo())

gere_aleatÃ³rio ([m], [n])

Gera nÃºmeros pseudo-aleatÃ³rios.

ParÃ¢metros

Sem argumentos: Retorna real no intervalo [0, 1).
m: Retorna inteiro no intervalo [1, m].
m, n: Retorna inteiro no intervalo [m, n].

Retorno

NÃºmero.

Exemplo

local dado = mat.gere_aleatÃ³rio(1, 6)

obtenha_cosseno (rad)

Retorna o cosseno de um Ã¢ngulo.

Parâmetros

rad: Número (radianos).

Retorno

NÃºmero.

obtenha_seno (rad)

Retorna o seno de um Ã¢ngulo.

Parâmetros

rad: Número (radianos).

Retorno

NÃºmero.

obtenha_tangente (rad)

Retorna a tangente de um Ã¢ngulo.

Parâmetros

rad: Número (radianos).

Retorno

NÃºmero.

obtenha_exponencial (x)

Calcula a exponencial e^x.

Parâmetros

x: Número.

Retorno

NÃºmero.

obtenha_logaritmo (x, [base])

Calcula o logaritmo de x.

Parâmetros

x: Número.
base: Número (opcional) - Padrão é e (log natural).

Retorno

NÃºmero.

obtenha_mÃ¡ximo (x, ...)

Retorna o maior valor entre os argumentos.

Parâmetros

x, ...: Números.

Retorno

NÃºmero.

obtenha_mÃnimo (x, ...)

Retorna o menor valor entre os argumentos.

Parâmetros

x, ...: Números.

Retorno

NÃºmero.

obtenha_raiz_quadrada (x)

Calcula a raiz quadrada de x.

Parâmetros

x: Número não-negativo.

Retorno

NÃºmero.

obtenha_valor_absoluto (x)

Retorna o valor absoluto (mÃ³dulo) de x.

ParÃ¢metros

x: NÃºmero.

Retorno

NÃºmero positivo.

frexp (x)

DecompÃµe x em mantissa e expoente (x = m * 2^e).

ParÃ¢metros

x: NÃºmero.

Retorno

NÃºmero (mantissa) e Inteiro (expoente).

ldexp (m, e)

RecompÃµe um nÃºmero a partir da mantissa e expoente (inverso de frexp).

ParÃ¢metros

m: NÃºmero - Mantissa.
e: Inteiro - Expoente.

Retorno

NÃºmero (m * 2^e).

verifique_menor_que_sem_sinal (m, n)

Verifica se m < n tratando ambos como inteiros sem sinal.

ParÃ¢metros

m, n: Inteiros.

Retorno

Booleano.

separe_fraÃ§Ã£o_inteiro (x)

Separa a parte inteira e a parte fracionÃ¡ria de x.

ParÃ¢metros

x: NÃºmero.

Retorno

NÃºmero (parte inteira) e NÃºmero (parte fracionÃ¡ria).

obtenha_resto_flutuante (x, y)

Retorna o resto da divisÃ£o de x por y (equivalente a fmod).

ParÃ¢metros

x, y: NÃºmeros.

Retorno

NÃºmero.

📘 Texto (texto)

ManipulaÃ§Ã£o de strings. MÃ©todos tambÃ©m disponÃveis via : em strings. Importe com local txt = importe("texto").

combine (s, Padrão)

Busca a primeira ocorrÃªncia do Padrão na string e retorna as capturas (match).

ParÃ¢metros

s: Texto - A string onde buscar.
Padrão: Texto - O Padrão Lua simplificado.

Retorno

Texto(s) capturado(s) ou nulo.

Exemplo

local dia, mes = txt.combine("Hoje Ã© 13/01", "(%d+)/(%d+)") -- "13", "01"

combine_globalmente (s, Padrão)

Retorna um iterador para todas as ocorrÃªncias do Padrão no texto (gmatch).

ParÃ¢metros

s: Texto - A string onde buscar.
Padrão: Texto - O Padrão a buscar repetidamente.

Retorno

Iterador (FunÃ§Ã£o).

Exemplo

para palavra em txt.combine_globalmente("Oi mundo sol", "%a+") faÃ§a ... fim

converta_para_maiÃºscula (s)

Retorna uma cÃ³pia do texto com todas as letras em maiÃºsculo.

ParÃ¢metros

s: Texto.

Retorno

Texto.

converta_para_minÃºscula (s)

Retorna uma cÃ³pia do texto com todas as letras em minÃºsculo.

ParÃ¢metros

s: Texto.

Retorno

Texto.

crie_caractere (cÃ³digo...)

Retorna uma string composta pelos caracteres correspondentes aos cÃ³digos numÃ©ricos fornecidos.

ParÃ¢metros

cÃ³digo...: Inteiros - CÃ³digos ASCII/Byte.

Retorno

Texto.

Exemplo

txt.crie_caractere(65, 66, 67) -- "ABC"

desempacote (formato, string)

Extrai valores de uma string binÃ¡ria seguindo um formato (similar ao struct.unpack de C).

ParÃ¢metros

formato: Texto - String de formato.
string: Texto - Dados binÃ¡rios.

Retorno

MÃºltiplos valores desempacotados.

empacote (formato, v1, v2...)

Empacota valores em uma string binÃ¡ria seguindo um formato (similar ao struct.pack de C).

ParÃ¢metros

formato: Texto - String de formato.
v1, v2...: Valores a empacotar.

Retorno

Texto (Dados binÃ¡rios).

obtenha_tamanho_pacote (formato)

Retorna o tamanho em bytes que o formato de empacotamento ocuparÃ¡.

ParÃ¢metros

formato: Texto.

Retorno

Inteiro.

despeje (f)

Retorna a representaÃ§Ã£o binÃ¡ria (bytecode) de uma funÃ§Ã£o Sol.

ParÃ¢metros

f: FunÃ§Ã£o.

Retorno

Texto (bytecode) ou nulo.

encontre (s, Padrão, [ini], [simples])

Retorna a posiÃ§Ã£o inicial e final da primeira ocorrÃªncia de um Padrão no texto.

ParÃ¢metros

s: Texto - Onde buscar.
Padrão: Texto - O que buscar.
ini: Inteiro (opcional) - Onde comeÃ§ar.
simples: Booleano (opcional) - Se verdadeiro, desativa padrÃµes regex.

Retorno

Inteiro (inÃcio), Inteiro (fim), ou nulo.

Exemplo

local i, j = txt.encontre("OlÃ¡ Sol", "Sol") -- 5, 7

formate (formato, ...)

Retorna uma string formatada seguindo o estilo printf.

ParÃ¢metros

formato: Texto - O formato.
...: Valores a formatar.

Retorno

Texto.

Exemplo

txt.formate("Valor: %.2f", 10.567) -- "Valor: 10.57"

inverta (s)

Inverte a ordem dos caracteres da string.

ParÃ¢metros

s: Texto.

Retorno

Texto.

obtenha_byte (s, [i], [j])

Retorna os cÃ³digos numÃ©ricos (ASCII/Unicode) dos caracteres da string.

ParÃ¢metros

s: Texto.
i: Inteiro (opcional) - InÃcio.
j: Inteiro (opcional) - Fim.

Retorno

Inteiros (mÃºltiplos valores).

obtenha_comprimento (s)

Retorna o tamanho da string em bytes. O operador # faz o mesmo.

ParÃ¢metros

s: Texto.

Retorno

Inteiro.

obtenha_subtexto (s, i, [j])

Extrai uma parte da string (substring) do Ãndice i ao j.

ParÃ¢metros

s: Texto.
i: Inteiro - InÃcio.
j: Inteiro (opcional) - Fim (Padrão -1).

Retorno

Texto.

Exemplo

txt.obtenha_subtexto("Teste", 1, 3) -- "Tes"

repita (s, n)

Retorna uma string contendo n cÃ³pias de s concatenadas.

ParÃ¢metros

s: Texto.
n: Inteiro.

Retorno

Texto.

Exemplo

txt.repita("Oi", 3) -- "OiOiOi"

substitua_globalmente (s, Padrão, repl, [n])

Substitui ocorrÃªncias do Padrão no texto por uma string de substituiÃ§Ã£o (gsub).

ParÃ¢metros

s: Texto.
Padrão: Texto.
repl: Texto/Tabela/FunÃ§Ã£o - O substituto.
n: Inteiro (opcional) - Limite de substituiÃ§Ãµes.

Retorno

Texto (resultado) e Inteiro (nÃºmero de substituiÃ§Ãµes).

Exemplo

txt.substitua_globalmente("Banana", "a", "o") -- "Bonono"

📊 Tabela (tabela)

ManipulaÃ§Ã£o de tabelas. Importe com local tab = importe("tabela").

concatene (lista, [sep], [i], [j])

Concatena os elementos de uma lista em uma Ãºnica string, separados por sep.

ParÃ¢metros

lista: Tabela.
sep: Texto (opcional) - Separador.
i: Inteiro (opcional) - InÃcio.
j: Inteiro (opcional) - Fim.

Retorno

Texto.

Exemplo

tab.concatene({"A", "B", "C"}, "-") -- "A-B-C"

crie (n, [v])

Cria uma tabela nova prÃ©-alocada com n elementos.

ParÃ¢metros

n: Inteiro - Capacidade da sequÃªncia.
v: Qualquer (opcional) - Valor inicial.

Retorno

Tabela.

desempacote (lista, [i], [j])

Retorna os elementos da tabela como valores soltos (argumentos).

ParÃ¢metros

lista: Tabela.
i: Inteiro (opcional) - InÃcio (Padrão 1).
j: Inteiro (opcional) - Fim (Padrão #lista).

Retorno

MÃºltiplos valores.

Exemplo

exiba(tab.desempacote({10, 20})) -- 10    20

empacote (...)

Cria uma nova tabela contendo todos os argumentos e um campo 'n' com o total.

ParÃ¢metros

...: Valores a empacotar.

Retorno

Tabela (com campo n).

insira (lista, [pos], valor)

Insere um elemento na lista em uma posiÃ§Ã£o especÃfica, deslocando os outros.

ParÃ¢metros

lista: Tabela.
pos: Inteiro (opcional) - PosiÃ§Ã£o de inserÃ§Ã£o. Padrão: fim.
valor: Qualquer - Elemento a inserir.

Exemplo

tab.insira(t, 1, "Topo")

mova (a1, f, e, t, [a2])

Move elementos da tabela a1 para a tabela a2 (ou a mesma).

ParÃ¢metros

a1: Tabela - Origem.
f: Inteiro - Ãndice inicial fonte.
e: Inteiro - Ãndice final fonte.
t: Inteiro - Ãndice inicial destino.
a2: Tabela (opcional) - Destino (Padrão a1).

Retorno

Tabela (a2).

ordene (lista, [comp])

Ordena os elementos de um array em ordem crescente ou usando uma funÃ§Ã£o de comparaÃ§Ã£o.

ParÃ¢metros

lista: Tabela.
comp: FunÃ§Ã£o (opcional) - FunÃ§Ã£o que recebe (a,b) e retorna verdadeiro se a < b.

Exemplo

tab.ordene(t) -- Crescente
tab.ordene(t, function(a,b) retorne a > b fim) -- Decrescente

remova (lista, [pos])

Remove um elemento da lista na posiÃ§Ã£o especificada.

ParÃ¢metros

lista: Tabela.
pos: Inteiro (opcional) - PosiÃ§Ã£o a remover. Padrão: Ãºltimo.

Retorno

Valor removido.

🖥️ Terminal (terminal)

Acesso a arquivos e terminal. Importe com local term = importe("terminal").

abra (arquivo, [modo])

Abre um arquivo. Modos: "r" (leitura), "w" (escrita), "a" (anexo).

local f = term.abra("dados.txt", "w")
f:escreva("OlÃ¡ Arquivo")
f:feche()

abra_processo (prog, [modo])

Inicia um processo e retorna um handle de arquivo (popen).

crie_arquivo_temporÃ¡rio ()

Retorna um arquivo temporÃ¡rio aberto para leitura/escrita.

defina_entrada (arquivo)

Define o arquivo Padrão para leitura (stdin).

defina_saÃda (arquivo)

Define o arquivo Padrão para escrita (stdout).

despeje (arquivo)

Salva dados do buffer no arquivo.

escreva (...)

Escreve na saÃda Padrão.

feche ([arquivo])

Fecha o arquivo dado ou o Padrão.

itere_linhas ([arquivo])

Iterador que lê o arquivo linha por linha.

para linha em term.itere_linhas("texto.txt") faça ... fim

leia ([fmt])

LÃª da entrada Padrão. Formatos: "a" (tudo), "l" (linha), "n" (nÃºmero).

obtenha_tipo (obj)

Verifica se Ã© um arquivo aberto ou fechado.

⚙️ Sistema Operacional (sistema_operacional)

Interação com o sistema operacional. Importe com local so = importe("sistema_operacional").

calcule_diferença_tempo (t2, t1)

Retorna a diferença em segundos entre dois tempos.

crie_pasta (caminho)

Cria um diretÃ³rio (mkdir).

defina_localidade (locale, [categoria])

Define a localidade do programa (setlocale).

execute ([comando])

Executa um comando do sistema.

so.execute("dir")

gere_nome_temporÃ¡rio ()

Gera um nome de arquivo Ãºnico.

obtenha_data ([formato], [tempo])

Retorna a data/hora formatada.

so.obtenha_data("%d/%m/%Y") -- "13/01/2026"

obtenha_relÃ³gio ()

Retorna o tempo de CPU usado pelo programa (clock).

obtenha_tempo ([tabela])

Retorna o timestamp atual (epoch) ou cria a partir de uma tabela.

obtenha_variÃ¡vel_ambiente (nome)

LÃª uma variÃ¡vel de ambiente.

local path = so.obtenha_variÃ¡vel_ambiente("PATH")

remova (arquivo)

Apaga um arquivo.

renomeie (antigo, novo)

Renomeia um arquivo.

saia ([codigo])

Encerra o programa.

🧶 Corrotina (corrotina)

ProgramaÃ§Ã£o cooperativa. Importe com local co = importe("corrotina").

ceda (valores...)

Suspende a execuÃ§Ã£o da corrotina atual.

co.ceda("pausando")

crie (f)

Cria uma nova corrotina. Retorna uma thread.

local c = co.crie(function() exiba("oi") fim)

envolva (f)

Cria uma corrotina e retorna uma funÃ§Ã£o para iniciÃ¡-la.

feche (co)

Fecha uma corrotina e libera recursos.

obtenha_estado (co)

Retorna o estado: "executando", "suspenso", "normal" ou "morto".

obtenha_executando ()

retome (co, [valores...])

Inicia ou continua a execuÃ§Ã£o da corrotina.

co.retome(c)

verifique_pode_ceder ()

Verifica se a corrotina atual pode ceder (yield).

📦 Pacote (pacote)

Gerenciamento de mÃ³dulos. Importe com local pac = importe("pacote").

busque_caminho (nome, caminho, [sep], [rep])

Procura por um arquivo em um caminho.

carregue_biblioteca (lib, func)

Carrega uma biblioteca C dinÃ¢mica (DLL/SO).

importe (modname)

Carrega um mÃ³dulo. FunÃ§Ã£o global Padrão.

local m = importe("meu_modulo")

🔤 UTF-8 (utf8)

ManipulaÃ§Ã£o de strings UTF-8. Importe com local u8 = importe("utf8").

crie_caractere (cÃ³digos...)

Cria uma string UTF-8 a partir de code points.

itere_cÃ³digos (s, [lax])

Iterador sobre code points UTF-8.

para p, c em u8.itere_cÃ³digos("AÃ§Ã£o") faÃ§a ... fim

obtenha_comprimento (s, [i], [j])

Retorna o nÃºmero de caracteres UTF-8 (nÃ£o bytes).

obtenha_deslocamento (s, n, [i])

Retorna o deslocamento em bytes de um caractere.

obtenha_ponto_cÃ³digo (s, [i], [j])

Retorna os code points da string.

Padrão_caractere

Padrão de string que combina com um caractere UTF-8.

🐞 Depuração (depuracao)

Ferramentas de depuraÃ§Ã£o. Importe com local dep = importe("depuracao").

defina_gancho (thread, hook, mask, [count])

Define uma funÃ§Ã£o de gancho (hook) para monitorar execuÃ§Ã£o.

defina_local (thread, nÃvel, n, valor)

Define o valor de uma variÃ¡vel local na pilha.

defina_metatabela (valor, tabela)

Define a metatabela de qualquer valor.

defina_valor_acima (f, up, valor)

Define o valor de um upvalue.

defina_valor_usuÃ¡rio (u, valor, [n])

Define o valor associado a um userdata.

entre_depuraÃ§Ã£o ()

Entra em modo interativo de depuraÃ§Ã£o.

id_valor_acima (f, n)

Retorna um ID Ãºnico para o upvalue.

junte_valor_acima (f1, n1, f2, n2)

Faz um upvalue de f1 referenciar o mesmo valor de f2.

obtenha_gancho ([thread])

Retorna as configuraÃ§Ãµes atuais do gancho.

obtenha_informaÃ§Ã£o ([thread], f, [opÃ§Ãµes])

Retorna informaÃ§Ãµes sobre uma funÃ§Ã£o ou nÃvel da pilha.

obtenha_local ([thread], nÃvel, n)

Retorna o nome e valor de uma variÃ¡vel local.

obtenha_metatabela (valor)

Retorna a metatabela de qualquer valor.

obtenha_rastreio ([thread], [msg], [nÃvel])

Retorna uma string com o stack trace.

obtenha_registro ()

Retorna a tabela de registro (Registry).

obtenha_valor_acima (f, up)

Retorna o nome e valor de um upvalue.

obtenha_valor_usuÃ¡rio (u, [n])

Retorna o valor associado a um userdata.

âš¡ Filamento (filamento)

Tarefas assÃncronas com corrotinas gerenciadas. Importe com local fil = importe("filamento").

durma (ms)

Pausa a execuÃ§Ã£o da tarefa atual por milissegundos.

fil.durma(1000)

inicie_loop ()

Inicia o loop de eventos para processar tarefas.

fil.inicie_loop()

tarefa (f)

Cria e agenda uma nova tarefa (corrotina gerenciada).

fil.tarefa(function() exiba("AssÃncrono!") fim)

⚡ Paralelismo (paralelo)

ExecuÃ§Ã£o em threads do SO. Importe com local par = importe("paralelo").

canal ()

Cria um canal de comunicaÃ§Ã£o entre threads.

local c = par.canal()

envie (canal, msg)

Envia uma mensagem (string) para o canal.

execute (script, [canal])

Inicia uma nova thread executando o script Sol.

par.execute("exiba('Nova Thread')", c)

receba (canal)

local msg = par.receba(c)

🧪 Teste (teste)

Framework de testes unitÃ¡rios. Importe com local t = importe("teste").

afirme (cond, [msg])

afirme_contem (tabela, valor)

afirme_diferente (a, b)

Verifica desigualdade.

afirme_erro (f)

Verifica se a funÃ§Ã£o lanÃ§a erro.

afirme_falso (v)

afirme_igual (a, b)

Verifica igualdade.

afirme_maior (a, b)

Verifica se a > b.

afirme_maior_igual (a, b)

Verifica se a >= b.

afirme_menor (a, b)

Verifica se a < b.

afirme_menor_igual (a, b)

Verifica se a <= b.

afirme_nÃ£o_nulo (v)

afirme_nulo (v)

afirme_sem_erro (f)

Verifica se a funÃ§Ã£o executa sem erros.

afirme_tamanho (n, t)

Verifica o tamanho da tabela/string.

afirme_tipo (tipo, v)

Verifica o tipo do valor.

afirme_vazio (t)

Verifica se a tabela estÃ¡ vazia.

afirme_verdadeiro (v)

antes_de_cada (f)

Executa antes de cada caso de teste.

antes_de_todos (f)

Executa uma vez antes de todos os testes.

caso (nome, f)

Define um caso de teste.

depois_de_cada (f)

Executa apÃ³s cada caso de teste.

depois_de_todos (f)

Executa uma vez apÃ³s todos os testes.

descreva (desc)

Define a descriÃ§Ã£o do grupo de testes atual.

execute ()

Inicia a execuÃ§Ã£o dos testes cronometrados.

falhe (msg)

ForÃ§a uma falha no teste.

grupo (nome, f)

Define um grupo de testes.

pule (msg)

Pula o teste atual.

reinicie ()

Reinicia o estado dos testes.

relatorio ()

Exibe o relatÃ³rio final dos testes.

📄 NDS (Notação de Dados Sol)

Biblioteca para serializaÃ§Ã£o e deserializaÃ§Ã£o de dados no formato Sol nativo.

Formato NDS: Similar a tabelas Sol, sem necessidade de retorne {}.

-- arquivo.nds
nome = "JoÃ£o"
idade = 30
endereco = {
    cidade = "SÃ£o Paulo",
    cep = "01234-567"
}

nds.carregue (texto)

Converte uma string no formato NDS para uma tabela Sol.

ParÃ¢metros

texto: Texto - ConteÃºdo NDS a ser parseado.

Retorno

Tabela ou (nulo, mensagem de erro).

Exemplo

local dados = nds.carregue([[
    nome = "Maria",
    ativo = verdadeiro
]])
exiba(dados.nome) -- "Maria"

nds.carregue_arquivo (caminho)

LÃª um arquivo NDS e retorna seu conteÃºdo como tabela.

ParÃ¢metros

caminho: Texto - Caminho para o arquivo .nds.

Retorno

Tabela ou (nulo, mensagem de erro).

Exemplo

local config = nds.carregue_arquivo("config.nds")
exiba(config.servidor)

nds.converta (tabela)

Converte uma tabela Sol para string no formato NDS.

ParÃ¢metros

tabela: Tabela - A tabela a serializar.

Retorno

Texto no formato NDS.

Exemplo

local dados = {nome = "JoÃ£o", idade = 25}
local texto = nds.converta(dados)
exiba(texto)
-- {
--     nome = "JoÃ£o",
--     idade = 25
-- }

nds.salve (caminho, tabela)

Salva uma tabela em um arquivo no formato NDS.

ParÃ¢metros

caminho: Texto - Caminho do arquivo de destino.
tabela: Tabela - Dados a salvar.

Retorno

verdadeiro ou (falso, mensagem de erro).

Exemplo

local dados = {usuario = "admin", nivel = 10}
nds.salve("usuario.nds", dados)

nds.converta_arquivo (tabela)

Converte uma tabela para string no formato de arquivo NDS (sem o wrapper de tabela).

ParÃ¢metros

tabela: Tabela - A tabela a serializar.

Retorno

Texto pronto para salvar em arquivo .nds.

Exemplo

local dados = {nome = "JoÃ£o", idade = 25}
local conteudo = nds.converta_arquivo(dados)
-- nome = "JoÃ£o"
--
-- idade = 25

📚 Biblioteca Padrão

🌐 Biblioteca Global (Base)

afirme (condição, [mensagem])

avise (mensagem)

carregue (código, [nome_chunk])

carregue_arquivo (caminho)

chame_protegido (função, [args...])

colete_lixo ([opção], [arg])

converta_para_número (valor, [base])

converta_para_texto (valor)

defina_metatabela (tabela, metatabela)

execute_arquivo (caminho)

exiba (valores...)

lance_erro (mensagem, [nível])

obtenha_metatabela (valor)

obtenha_pares (tabela)

obtenha_pares_indexados (tabela)

obtenha_tipo (valor)

selecione (índice, ...)

➗ Matemática (math)

arredonde_para_piso (x)

arredonde_para_teto (x)

converta_para_graus (rad)

converta_para_inteiro (x)

converta_para_radianos (graus)

defina_semente_aleatÃ³ria (x)

gere_aleatÃ³rio ([m], [n])

obtenha_cosseno (rad)

obtenha_seno (rad)

obtenha_tangente (rad)

obtenha_exponencial (x)

obtenha_logaritmo (x, [base])

obtenha_mÃ¡ximo (x, ...)

obtenha_mÃ­nimo (x, ...)

obtenha_raiz_quadrada (x)

obtenha_valor_absoluto (x)

frexp (x)

ldexp (m, e)

verifique_menor_que_sem_sinal (m, n)

separe_fraÃ§Ã£o_inteiro (x)

obtenha_resto_flutuante (x, y)

📘 Texto (texto)

combine (s, Padrão)

combine_globalmente (s, Padrão)

converta_para_maiÃºscula (s)

converta_para_minÃºscula (s)

crie_caractere (cÃ³digo...)

desempacote (formato, string)

empacote (formato, v1, v2...)

obtenha_tamanho_pacote (formato)

despeje (f)

encontre (s, Padrão, [ini], [simples])

formate (formato, ...)

inverta (s)

obtenha_byte (s, [i], [j])

obtenha_comprimento (s)

obtenha_subtexto (s, i, [j])

repita (s, n)

substitua_globalmente (s, Padrão, repl, [n])

📊 Tabela (tabela)

concatene (lista, [sep], [i], [j])

crie (n, [v])

desempacote (lista, [i], [j])

empacote (...)

insira (lista, [pos], valor)

mova (a1, f, e, t, [a2])

ordene (lista, [comp])

remova (lista, [pos])

🖥️ Terminal (terminal)

abra (arquivo, [modo])

abra_processo (prog, [modo])

crie_arquivo_temporÃ¡rio ()

defina_entrada (arquivo)

defina_saÃ­da (arquivo)

despeje (arquivo)

escreva (...)

feche ([arquivo])

itere_linhas ([arquivo])

leia ([fmt])

obtenha_tipo (obj)

obtenha_mÃnimo (x, ...)

defina_saÃda (arquivo)

defina_local (thread, nÃvel, n, valor)

obtenha_local ([thread], nÃvel, n)

obtenha_rastreio ([thread], [msg], [nÃvel])