Referência

Palavras reservadas

f var arr map print params return true false nil input cond while until for eng if elif else match and or not pick struct sonof interface action super nocall

(each e in valem dentro do for.)

(val e case valem dentro do match.)

Funções que já vêm na linguagem

Funções suas com o mesmo nome têm prioridade sobre as da linguagem.

Listas e mapas

Texto

As posições contam letras (não bytes), então "ação" tem 4.

slice ajusta limites que passam do tamanho em vez de dar erro (slice:"abc":2:99 dá "c").

Conversão e números

As conversões não dão erro: devolvem nil quando não dá, para combinar com ??.

var pagina = int:(Http.query:"p") ?? 1
var titulo = replace:(trim:(Http.form:"titulo")):"  ":" "
var url = "/posts/" + (slug:titulo)

Arquivos e includes

include:"arq" executa outro arquivo da pasta do site. Veja File abaixo para ler e gravar.

Json

Json.encode:x, Json.pretty:x, Json.decode:s, Json.valid:s. Veja Mapas e Json.

Http

action (função que vira endpoint para agentes, veja Agentes). Rotas (rotas.djo: Route.get:, Route.post:, Route.static:...), entrada (Http.query:, Http.param:, Http.args:, Http.form:...), resposta (Http.json:, Http.redirect:...) e saída (Http.get:, Http.post:, Http.put:, Http.delete:). Veja Web.

File

Lê e grava arquivos dentro da pasta do projeto (a do script, ou a do site em djo serve). Os caminhos são relativos: "dados/leituras.txt".

var agora = Time.now:
File.append:"leituras.csv":(str:agora) + ",23.5\n"
for{
    each[linha in split:(trim:(File.read:"leituras.csv" ?? "")):"\n"]
    print linha
}
File.write:"estado.json":(Json.encode:{"ligado": true})

• Só texto: para dados use Json.encode: ao gravar e Json.decode: ao ler.
• Nada sai da pasta do projeto: .., caminhos absolutos e links simbólicos que apontam para fora dão erro.
• File.write grava num arquivo temporário e renomeia, então quem lê nunca vê o arquivo pela metade.
• Limites: 10 MB por leitura e por gravação.
• Nunca monte o caminho com texto de visitante (File.read:Http.query:"arq"): um visitante poderia ler blog.db ou qualquer arquivo do site. Valide contra uma lista fixa.

Em djo serve há regras extras de gravação, para uma página não virar um jeito de plantar código: não se grava .djo, .html, .htm, .svg, .js, .xml nem nada dentro de core/; e cada página grava no máximo 10 MB. Guarde seus dados numa pasta que começa com _ (como _dados/): o servidor nunca serve esses arquivos, então ninguém os baixa pela URL.

Session, Hash, upload

Veja Web.

Serial

Porta serial para sensores e placas. Veja Hardware.

Db

Veja Banco de dados.

Time

Datas são Int: segundos desde 1970 (UTC). Somar e subtrair é aritmética comum (Time.now: + 3600 é daqui a uma hora).

Formatos: YYYY ano, MM mês, DD dia, HH hora (0 a 23), mm minuto, ss segundo. Pode usar os símbolos - / : . , e espaço. Outras letras e números soltos dão erro.

var agora = Time.now:
print Time.format:agora:"DD/MM/YYYY HH:mm"         // 31/01/2025 14:05
var t = Time.parse:"2025-01-31":"YYYY-MM-DD"
print (Time.date:t)["month"]                       // 1

Mensagens de erro

Todo erro traz a linha: erro (linha 12): .... Os mais comuns:

Ainda não existe

Compilação para WASM, GPIO, I2C e SPI, expressões regulares, formatação de números (format), datas em outros fusos e a assinatura de apps. Sessões em disco (hoje ficam na memória) também.