Pular para o conteúdo

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.

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.

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
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
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

dbSet, dbSetExpire, dbGet, dbDel, dbIncr, dbTop e dbKeys lembram coisas entre usos. Veja Dados guardados.

cembed e complexMessage estão em Embeds e mensagens.

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.

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.