Biblioteca Padrão do Zig (std) — Referência em Português

Biblioteca Padrão do Zig (std)

A biblioteca padrão do Zig (std) oferece um conjunto abrangente de módulos para operações fundamentais de programação — desde manipulação de memória e I/O até redes, criptografia e estruturas de dados. Esta referência documenta cada módulo com explicações em português brasileiro, assinaturas de funções e exemplos práticos.

Como usar a biblioteca padrão

Para acessar qualquer módulo da biblioteca padrão, basta importar std:

const std = @import("std");

A partir daí, você pode acessar qualquer submódulo diretamente:

const io = std.io;
const mem = std.mem;
const fs = std.fs;

Módulos por Categoria

Entrada e Saída (I/O)

MóduloDescrição
std.ioVisão geral do sistema de I/O
std.io.WriterInterface genérica de escrita
std.io.ReaderInterface genérica de leitura
std.io BufferedBufferedReader e BufferedWriter
std.io.FixedBufferStreamStream sobre buffer fixo
getStdOut, getStdErr, getStdInAcesso aos fluxos padrão

Sistema de Arquivos

MóduloDescrição
std.fsVisão geral do sistema de arquivos
std.fs.cwd()Diretório atual e operações
std.fs.FileTipo File e operações
std.fs.pathUtilitários de caminhos
std.fs.DirTipo Dir e iteração

Memória

MóduloDescrição
std.memVisão geral de operações de memória
std.mem.AllocatorInterface de alocador
std.mem.eqlComparação e busca em memória
std.mem.splitDivisão e tokenização
std.heapVisão geral dos alocadores
GeneralPurposeAllocatorAlocador de uso geral
ArenaAllocatorAlocador de arena
page_allocatorAlocador de páginas
FixedBufferAllocatorAlocador sobre buffer fixo

Estruturas de Dados

MóduloDescrição
ArrayListLista dinâmica (vetor)
ArrayHashMapHashMap com ordem de inserção
HashMapTabela hash genérica
StringHashMapHashMap com chaves string
MultiArrayListStruct of Arrays
BoundedArrayArray com tamanho limitado
PriorityQueueFila de prioridade (heap)
SegmentedListLista segmentada
LinkedListListas ligadas

Formatação e Parsing

MóduloDescrição
std.fmtVisão geral de formatação
Sintaxe de FormatStrings de formatação
parseInt, parseFloatConversão de strings para números
std.jsonVisão geral de JSON
JSON ParsingAnálise de JSON
JSON StringifySerialização JSON
std.UriAnálise de URIs
std.base64Codificação Base64

Rede

MóduloDescrição
std.netVisão geral de rede
std.net.StreamSocket Stream
std.net.AddressTipo Address
std.httpVisão geral HTTP
HTTP ClientCliente HTTP
HTTP ServerServidor HTTP

Threads e Concorrência

MóduloDescrição
std.ThreadThreads nativas
Thread.MutexMutex e sincronização
Thread.PoolPool de threads
std.atomicOperações atômicas
Event LoopConceitos de event loop

Matemática e Criptografia

MóduloDescrição
std.mathVisão geral de matemática
Funções matemáticasFunções comuns
std.cryptoVisão geral de criptografia
Hash functionsFunções de hash
Crypto randomNúmeros aleatórios criptográficos
std.compressCompressão de dados

Sistema Operacional e Utilitários

MóduloDescrição
std.osInterface com o SO
std.processProcessos e ambiente
std.timeTempo e cronômetros
std.debugDepuração e assertivas
std.logFramework de logging
std.testingUtilitários de teste
std.sortAlgoritmos de ordenação

Convenções da Biblioteca Padrão

A biblioteca padrão do Zig segue algumas convenções importantes:

  • Alocadores explícitos: Funções que alocam memória recebem um Allocator como parâmetro, tornando a gestão de memória transparente.
  • Tratamento de erros: Funções que podem falhar retornam error union (!T), integrando-se com o sistema de try/catch do Zig.
  • Genéricos via comptime: Muitas estruturas usam parâmetros comptime para tipagem genérica sem custo em tempo de execução.
  • Zero-cost abstractions: Interfaces como Writer e Reader utilizam ponteiros de função resolvidos em tempo de compilação quando possível.

Recursos Adicionais