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, reúne os módulos oficiais usados para memória, arquivos, entrada e saída, HTTP, JSON, criptografia, testes, threads e estruturas de dados. Ela acompanha o compilador: você não instala um pacote separado para usar std.mem, std.fs, std.http ou std.testing.

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: importe a biblioteca com const std = @import("std"); e acesse o módulo necessário, como std.mem, std.fs ou std.json. Como a API da stdlib evolui junto com o Zig, confirme exemplos na documentação correspondente à 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.

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

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.

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. Para uma visão compacta, veja também o cheatsheet da biblioteca padrão essencial.

Recursos adicionais

• O que é Zig e para que serve
• Receitas práticas em Zig
• Documentação oficial da stdlib (em inglês)