Funções
Cada função é escrita como nome argumento argumento. Os números entre parênteses são quantos argumentos ela recebe.
Um texto que contém um número (como os argumentos de um comando) é aceito onde um número for necessário.
Lógica e comparação
Seção intitulada “Lógica e comparação”| Função | O que faz | Exemplo |
|---|---|---|
eq a b ... (2+) |
Verdadeiro se a for igual a algum dos outros |
eq .User.Username "Liam" "Santi" |
ne a b |
Não é igual | ne 1 2 |
lt a b, le a b, gt a b, ge a b |
Menor, menor ou igual, maior, maior ou igual. Dois números ou dois textos | gt (len .Args) 2 |
not x |
O contrário da verdade de x |
not (hasRole "...") |
and a b ... |
O primeiro valor falso, ou o último | and 1 "" dá "" |
or a b ... |
O primeiro valor verdadeiro, ou o último | or .Member.Nick .User.Username |
and e or olham todos os seus argumentos antes de decidir.
Números
Seção intitulada “Números”| Função | O que faz |
|---|---|
add a b ..., sub a b ..., mult a b ... |
Somar, subtrair (a partir do primeiro), multiplicar |
div a b |
Dividir. Dividir por zero é um erro. div 9 2 é 4.5 |
mod a b |
O resto |
pow a b |
Potência (o expoente tem limite de 1000) |
floor x, ceil x, round x, abs x |
Arredondamento e valor absoluto |
min a ..., max a ... |
O menor e o maior |
toInt x |
Um número inteiro a partir de um texto ou número, 0 se não for. toInt "42abc" é 0 |
toFloat x |
Um número a partir de um texto, 0 se não for |
randInt high / randInt low high |
Um número inteiro aleatório de low até high sem incluí-lo |
| Função | O que faz |
|---|---|
str x |
Qualquer valor como texto |
print a b ... |
Junta valores como texto, sem espaços |
printf formato valores... |
Preenche um formato: %s texto, %d inteiro, %.2f decimais, %t verdadeiro ou falso, %q entre aspas, %x hexadecimal, %5s e %-5s largura, %% um sinal de porcentagem. Um valor que falta imprime %!d(MISSING) |
lower x, upper x, title x, trim x |
Maiúsculas e espaços em branco |
contains texto parte |
Se o texto tem a parte |
hasPrefix texto início, hasSuffix texto fim |
Começa ou termina com |
replace texto de para |
Troca cada de por para |
split texto separador |
Uma lista com as partes |
join lista separador |
Um único texto a partir de uma lista |
len x |
Caracteres de um texto, itens de uma lista, nomes de um mapa |
slice x de até |
Parte de um texto ou de uma lista. até é opcional |
Listas e mapas
Seção intitulada “Listas e mapas”| Função | O que faz |
|---|---|
cslice a b ... |
Cria uma lista |
dict "chave" valor ... / sdict ... |
Cria um mapa a partir de pares. As duas funcionam igual: as chaves são sempre texto |
index x posição |
O item de uma lista (a partir de 0) ou o valor de um mapa (nil se não existir). Mais chaves vão mais fundo: index .M "a" "b" |
append lista valor |
Uma lista nova com o valor adicionado |
in lista valor |
Se o valor está na lista |
keys mapa |
Os nomes de um mapa, como lista |
seq de até |
Os números inteiros de de até até sem incluí-lo (no máximo 1000) |
shuffle lista |
Uma lista nova em ordem aleatória |
Menções, tempo e cargos
Seção intitulada “Menções, tempo e cargos”| Função | O que faz |
|---|---|
mentionUser "id", mentionRole "id", mentionChannel "id" |
<@id>, <@&id> e <#id>. O ID deve ser um texto de 15 a 22 dígitos |
unix |
Os segundos desde 1970, agora |
timestamp segundos estilo |
Um carimbo de tempo do Discord como <t:1700000000:R>. Estilos: t T d D f F R, f se omitido |
humanizeDuration segundos |
90061 vira 1d 1h 1m 1s |
hasRole "id" |
Se o membro que usou o comando tem esse cargo |
Dados guardados
Seção intitulada “Dados guardados”dbSet, dbSetExpire, dbGet, dbDel, dbIncr, dbTop e dbKeys lembram coisas entre usos. Veja Dados guardados.
Embeds e mensagens
Seção intitulada “Embeds e mensagens”cembed e complexMessage estão em Embeds e mensagens.
Botões e menus
Seção intitulada “Botões e menus”cbutton, cselect e crow estão em Botões e menus, com respond e updateMessage. ctext, cmodal e showModal, os formulários que aparecem, estão na mesma página.
Reações
Seção intitulada “Reações”removeReaction, e as "reactions" de complexMessage, estão em Reações.
sendMessage, sendDM, addRole, removeRole, addReaction, deleteTrigger, respond e updateMessage estão em Ações.
