std.net.Stream em Zig — Referência e Exemplos
std.net.Stream — Conexão TCP Bidirecional O std.net.Stream representa uma conexão TCP estabelecida e bidirecional. Ele encapsula um descritor de socket do sistema …
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ódulo | Descrição |
|---|---|
| std.io | Visão geral do sistema de I/O |
| std.io.Writer | Interface genérica de escrita |
| std.io.Reader | Interface genérica de leitura |
| std.io Buffered | BufferedReader e BufferedWriter |
| std.io.FixedBufferStream | Stream sobre buffer fixo |
| getStdOut, getStdErr, getStdIn | Acesso aos fluxos padrão |
Sistema de Arquivos
| Módulo | Descrição |
|---|---|
| std.fs | Visão geral do sistema de arquivos |
| std.fs.cwd() | Diretório atual e operações |
| std.fs.File | Tipo File e operações |
| std.fs.path | Utilitários de caminhos |
| std.fs.Dir | Tipo Dir e iteração |
Memória
| Módulo | Descrição |
|---|---|
| std.mem | Visão geral de operações de memória |
| std.mem.Allocator | Interface de alocador |
| std.mem.eql | Comparação e busca em memória |
| std.mem.split | Divisão e tokenização |
| std.heap | Visão geral dos alocadores |
| GeneralPurposeAllocator | Alocador de uso geral |
| ArenaAllocator | Alocador de arena |
| page_allocator | Alocador de páginas |
| FixedBufferAllocator | Alocador sobre buffer fixo |
Estruturas de Dados
| Módulo | Descrição |
|---|---|
| ArrayList | Lista dinâmica (vetor) |
| ArrayHashMap | HashMap com ordem de inserção |
| HashMap | Tabela hash genérica |
| StringHashMap | HashMap com chaves string |
| MultiArrayList | Struct of Arrays |
| BoundedArray | Array com tamanho limitado |
| PriorityQueue | Fila de prioridade (heap) |
| SegmentedList | Lista segmentada |
| LinkedList | Listas ligadas |
Formatação e Parsing
| Módulo | Descrição |
|---|---|
| std.fmt | Visão geral de formatação |
| Sintaxe de Format | Strings de formatação |
| parseInt, parseFloat | Conversão de strings para números |
| std.json | Visão geral de JSON |
| JSON Parsing | Análise de JSON |
| JSON Stringify | Serialização JSON |
| std.Uri | Análise de URIs |
| std.base64 | Codificação Base64 |
Rede
| Módulo | Descrição |
|---|---|
| std.net | Visão geral de rede |
| std.net.Stream | Socket Stream |
| std.net.Address | Tipo Address |
| std.http | Visão geral HTTP |
| HTTP Client | Cliente HTTP |
| HTTP Server | Servidor HTTP |
Threads e Concorrência
| Módulo | Descrição |
|---|---|
| std.Thread | Threads nativas |
| Thread.Mutex | Mutex e sincronização |
| Thread.Pool | Pool de threads |
| std.atomic | Operações atômicas |
| Event Loop | Conceitos de event loop |
Matemática e Criptografia
| Módulo | Descrição |
|---|---|
| std.math | Visão geral de matemática |
| Funções matemáticas | Funções comuns |
| std.crypto | Visão geral de criptografia |
| Hash functions | Funções de hash |
| Crypto random | Números aleatórios criptográficos |
| std.compress | Compressão de dados |
Sistema Operacional e Utilitários
| Módulo | Descrição |
|---|---|
| std.os | Interface com o SO |
| std.process | Processos e ambiente |
| std.time | Tempo e cronômetros |
| std.debug | Depuração e assertivas |
| std.log | Framework de logging |
| std.testing | Utilitários de teste |
| std.sort | Algoritmos 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
Allocatorcomo 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 detry/catchdo Zig. - Genéricos via comptime: Muitas estruturas usam parâmetros
comptimepara tipagem genérica sem custo em tempo de execução. - Zero-cost abstractions: Interfaces como
WritereReaderutilizam ponteiros de função resolvidos em tempo de compilação quando possível.
Recursos Adicionais
Biblioteca Padrão do Zig (std) — Referência em Português61 itens
std.os em Zig — Referência e Exemplos
std.os — Interface com o Sistema Operacional O módulo std.os (e seu complemento std.posix) fornece acesso direto às APIs do sistema operacional. No Zig, a filosofia é …
std.PriorityQueue em Zig — Referência e Exemplos
std.PriorityQueue — Fila de Prioridade O std.PriorityQueue implementa uma fila de prioridade baseada em heap binário. Ele permite inserir elementos com prioridades …
std.process em Zig — Referência e Exemplos
std.process — Gerenciamento de Processos O módulo std.process fornece funcionalidades para gerenciar processos no Zig. Isso inclui a execução de processos filhos, acesso …
std.SegmentedList em Zig — Referência e Exemplos
std.SegmentedList — Lista Segmentada O std.SegmentedList é uma estrutura de dados que combina as vantagens de arrays e listas encadeadas. Diferente do ArrayList, que …
std.sort em Zig — Referência e Exemplos
std.sort — Ordenação de Dados O módulo std.sort fornece algoritmos de ordenação eficientes para slices no Zig. A implementação padrão utiliza um algoritmo adaptativo …
std.StringHashMap em Zig — Referência e Exemplos
std.StringHashMap — HashMap Especializado para Strings O std.StringHashMap é uma especialização do HashMap otimizada para chaves do tipo []const u8 (strings). Ele oferece …
std.testing em Zig — Referência e Exemplos
std.testing — Framework de Testes O módulo std.testing é o framework de testes integrado ao Zig. Ele fornece funções de asserção, um allocator de teste que detecta leaks …
std.Thread em Zig — Referência e Exemplos
std.Thread — Threads Nativas O módulo std.Thread fornece acesso a threads nativas do sistema operacional no Zig. Ele permite criar threads, aguardar sua conclusão, e …
std.Thread.Mutex em Zig — Referência e Exemplos
std.Thread.Mutex — Exclusão Mútua O std.Thread.Mutex é a primitiva fundamental de sincronização do Zig para proteger dados compartilhados entre threads. Ele garante que …
std.Thread.Pool em Zig — Referência e Exemplos
std.Thread.Pool — Pool de Threads O std.Thread.Pool gerencia um conjunto reutilizável de threads de trabalho (worker threads) que processam tarefas de uma fila …
std.time em Zig — Referência e Exemplos
std.time — Tempo e Medição de Performance O módulo std.time fornece funcionalidades para trabalhar com tempo no Zig, incluindo medição de alta resolução, timestamps, …