Biblioteca padrão

v0.0.18Suporte e limites ↗

Esta documentação descreve o escopo congelado da pré-versão experimental v0.0.18. A publicação efetiva e os downloads estão registrados no GitHub Releases. Estes pontos de entrada essenciais foram conferidos no código-fonte; não é uma referência exaustiva da API. O contrato de sintaxe define o comportamento. Consulte a matriz de suporte para os limites dos backends.

Importe módulos

import fs from "std.fs"
import json from "std.json"
import { http, time } from "std"

fs, http, config, task, pg, redis, mysql, bytes e net exigem importações explícitas. Alguns módulos históricos ainda podem ser chamados diretamente; os novos exemplos preferem importações explícitas para esclarecer as dependências. std.task é um espaço de nomes interno para observação e testes de estresse, não uma API de concorrência para aplicações.

Módulo	Finalidade	Limites a lembrar
`std.string` / métodos de string	Comprimento Unicode, comprimento em bytes, busca, recortes	`trim/lower/upper` nativos não têm implementação Unicode
`std.array` / métodos de array	Comprimento, busca, novos arrays, map	A falha de um índice direto difere do `try_get` recuperável
`std.object`	Busca com alternativa explícita via `get_or`	Um índice comum ausente não assume null por padrão
std.json	Codificação e decodificação estritas de JSON	Sem suporte em Tasks nativos e LLVM
`std.fs`	Arquivos, verificação de existência, listagem de diretórios	Caminhos relativos são resolvidos a partir do diretório do código `.ku` atual
`std.time`	Hora, datas, durações, pausas	Esperas síncronas e de Tasks usam caminhos de execução diferentes
`std.http`	Clientes HTTP, serviços, respostas	Permanecem diferenças de backend e ciclo de vida; não é uma implementação completa de rede genérica para Tasks
`std.config`	Ambiente e configuração	Não versionar credenciais reais no código
`std.pg` / `std.redis` / `std.mysql`	Clientes unificados com pools limitados	Somente nativos; validação em servidores reais e limites TLS exigem verificações separadas
`std.bytes` / `std.net`	Dados binários, cliente TCP, TLS opcional	Caminho C nativo gerado; TLS exige um pacote correspondente ao destino
`std.lexer` / `std.parser`	Auxiliares de depuração do compilador	Retornam resumos de depuração, não estruturas públicas completas de Token / AST

Assinaturas comuns

Estas são assinaturas de documentação. & indica um modo de parâmetro somente para leitura suportado; T! indica um resultado recuperável:

len(&value:any): int
str(&value:any): str
println(&value:any): null
string.len(&text:str): int
string.byte_len(&text:str): int
string.slice(text:str, start:int, end:int): str!
array.len(&values:[T]): int
array.try_get(values:[T], index:int): T!
fs.read(path:str): str!
fs.write(path:str, text:str): null!
fs.exists(path:str): bool
fs.read_dir(path:str): [str]!

"中😀".len() é 2 e .byte_len() é 7. O comprimento conta valores escalares Unicode; os recortes usam índices de caracteres, não bytes UTF-8. array.push e array.concat retornam novos arrays sem alterar suas entradas.

Leia um arquivo

import fs from "std.fs"

fn main(): null! {
    text = fs.read("message.txt")?
    println(text)
    return ok(null)
}

Primeiro crie um message.txt em UTF-8 ao lado do código-fonte. Um arquivo ausente ou uma leitura malsucedida retorna um erro. Este exemplo depende desse arquivo de entrada. try_read e try_write continuam sendo aliases compatíveis com os mesmos tipos de resultado.

read_dir retorna caminhos ordenados com propriedade independente, limitados a 10.000 entradas e 1.000.000 de bytes de caminho no total. As operações de arquivo do subconjunto Task nativo restrito usam um pool fixo em segundo plano. Isso não comprova esperas de rede genéricas pelo mesmo mecanismo.

Manutenção da referência

Os metadados das interfaces públicas ficam em src/stdlib/metadata.rs. Eles são verificados com as implementações e os contratos. Atualmente o site mantém uma referência manual selecionada; a existência de um comando ku doc não foi confirmada.

API reference (English)

Detailed module references and runnable examples are currently available in English: