Biblioteca Padrão do Zig (stdlib): Guia dos Módulos std com Exemplos

Biblioteca Padrão do Zig (stdlib): módulos std em português

A biblioteca padrão do Zig, também chamada de Zig stdlib ou simplesmente std, é a coleção de módulos oficiais que acompanha o compilador: memória, arquivos, entrada e saída, HTTP, JSON, criptografia, testes, threads e estruturas de dados. Não existe instalação separada — const std = @import("std"); disponibiliza tudo, de std.mem a std.http.

Esta página funciona como um mapa da stdlib em português. Se você quer resolver uma tarefa específica, comece pela tabela abaixo; se está aprendendo a linguagem, siga a rota recomendada no fim do guia.

Resposta rápida: a stdlib do Zig é o namespace std importado com const std = @import("std");. Ela já vem com o compilador, sem npm install ou cargo add. Acesse o módulo necessário, como std.mem, std.fs ou std.json. Como a API evolui junto com o Zig (a reescrita de I/O das versões 0.15/0.16 mudou std.io), confirme exemplos na documentação da versão do seu compilador.

Como importar e usar std

A biblioteca padrão já está disponível em qualquer arquivo Zig:

const std = @import("std");

pub fn main() !void {
    const texto = "zig,stdlib,portugues";
    var partes = std.mem.splitScalar(u8, texto, ',');

    while (partes.next()) |parte| {
        std.debug.print("{s}\n", .{parte});
    }
}

Você pode criar aliases quando isso melhora a leitura, embora usar o caminho completo geralmente deixe a origem de cada API mais clara:

const std = @import("std");
const mem = std.mem;
const fs = std.fs;

Não existe um comando equivalente a npm install std ou cargo add std: a biblioteca padrão faz parte da distribuição do Zig.

O comando zig std: documentação offline no navegador

Resposta rápida: zig std é o comando do compilador Zig que abre a documentação da biblioteca padrão da versão instalada no seu navegador, a partir de um servidor local. Não precisa de internet e não precisa instalar nada além do próprio Zig:

zig std   # inicia um servidor local com a documentação da stdlib
zig version   # mostra a versão do compilador (e, portanto, da stdlib)

A documentação gerada por zig std é pesquisável e navegação por símbolo: cada tipo, função e módulo (std.mem, std.json, std.fmt…) tem sua página com assinatura e código-fonte.

Como a API da stdlib muda entre versões (a reescrita de I/O do Zig 0.15/0.16 é o exemplo mais recente), o ideal é consultar a documentação da versão que você usa — e é exatamente isso que o zig std entrega, sem depender de um site externo estar atualizado.

Qual módulo da stdlib usar?

Módulos por categoria

Entrada e Saída (I/O)

Sistema de Arquivos

Memória

Estruturas de Dados

Formatação e Parsing

Rede

Atenção (Zig 0.15/0.16): a reescrita de I/O conhecida como Writergate substituiu std.io.getStdOut().writer() e o padrão bufferedWriter pela nova interface std.Io.Writer. Se o seu código parou de compilar, veja o guia de migração Writergate em português.

Threads e Concorrência

Matemática e Criptografia

Sistema Operacional e Utilitários

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 normalmente recebem um Allocator, deixando custo e ciclo de vida visíveis.
• Tratamento de erros: funções que podem falhar retornam uma error union (!T) e se integram a try, catch e errdefer.
• Genéricos via comptime: muitas APIs recebem tipos e funções em tempo de compilação, sem exigir um sistema separado de generics.
• Slices em vez de strings especiais: texto UTF-8 costuma aparecer como []const u8; operações comuns ficam em std.mem, std.ascii, std.unicode e std.fmt.
• Recursos liberados com defer: arquivos, alocações, sockets e outras estruturas frequentemente expõem close, free ou deinit.
• APIs dependentes da versão: nomes, assinaturas e padrões podem mudar entre versões do Zig, principalmente antes do 1.0.

A stdlib é estável entre versões do Zig?

Ainda não completamente. Zig permanece antes da versão 1.0, portanto a biblioteca padrão pode ganhar novos módulos, remover APIs antigas ou alterar assinaturas. Um exemplo copiado para uma versão diferente do compilador pode falhar mesmo quando o conceito continua correto.

Confira sua versão antes de adaptar um exemplo:

zig version

Para documentação local e experimentação, zig std inicia o navegador de documentação fornecido pelo compilador quando esse comando está disponível na sua versão. Para APIs em evolução, também consulte a documentação oficial da versão master e compare com a versão instalada.

Rota de aprendizado da stdlib

Se você está começando, não tente memorizar todos os módulos. Uma sequência prática é:

1. Aprenda slices e strings com std.mem e o guia de strings e arrays.
2. Entenda alocação com std.mem.Allocator e o tutorial de gerenciamento de memória.
3. Pratique coleções com ArrayList e HashMap.
4. Leia e grave dados com std.fs, std.fmt e std.json.
5. Automatize a verificação com std.testing.
6. Só depois avance para rede, concorrência, criptografia ou integração com o sistema operacional.

Perguntas frequentes

O que é std em Zig?

std é o namespace da biblioteca padrão oficial que acompanha o compilador Zig. O código const std = @import("std"); disponibiliza módulos como std.mem, std.fs, std.http, std.json, std.testing e std.heap.

Zig tem gerenciador de pacotes para a biblioteca padrão?

A stdlib não precisa ser instalada pelo gerenciador de pacotes: ela já acompanha o compilador. O sistema de pacotes é usado para dependências externas do projeto, enquanto @import("std") referencia a biblioteca padrão da versão instalada.

Qual é a diferença entre std.mem e std.heap?

std.mem concentra operações sobre memória e slices, além de definir a interface Allocator. std.heap oferece implementações concretas de alocadores, como arena, páginas e alocadores de uso geral. Em outras palavras, std.mem.Allocator define o contrato; std.heap fornece várias estratégias para cumpri-lo.

Como abrir a documentação da stdlib do Zig?

Execute zig std para iniciar o navegador de documentação que acompanha o compilador (disponível nas versões recentes) — a seção acima sobre o comando zig std detalha o uso. Ou consulte a documentação oficial da stdlib em inglês. Compare sempre com a versão instalada via zig version.

O que mudou na stdlib do Zig 0.15 e 0.16?

A principal mudança foi a reescrita do sistema de I/O: a interface std.Io.Writer/std.Io.Reader substituiu APIs antigas como getStdOut().writer() e bufferedWriter. O guia Writergate em Zig: migrar getStdOut para std.Io.Writer mostra o antes e o depois com exemplos.

Onde encontro exemplos da biblioteca padrão do Zig em português?

Use as páginas ligadas neste índice para consultar módulos individuais com explicações e exemplos, e o tutorial de servidor HTTP em Zig para um projeto completo usando a stdlib. Para uma visão compacta, veja também o cheatsheet da biblioteca padrão essencial.

Recursos adicionais

• O que é Zig e para que serve
• Migração Writergate: getStdOut para std.Io.Writer
• Receitas práticas em Zig
• Documentação oficial da stdlib (em inglês)