Skip to content

Zig Folha de referência

Linguagem de programação e toolchain de uso geral para programas robustos e otimizados.

01

Primeiros Passos

Hello World

Zig usa @import para a biblioteca padrão; print usa strings de formato avaliadas em comptime.

zig
const std = @import("std");

pub fn main() void {
    std.debug.print("Hello, {s}\n", .{"World"}});
}

Variáveis

const é imutável, var é mutável. Os tipos são explícitos ou inferidos.

zig
const x: i32 = 10;
var y: i32 = 20;
y += 5;

Funções

Funções usam a palavra-chave fn; pub as torna públicas.

zig
fn add(a: i32, b: i32) i32 {
    return a + b;
}

pub fn main() void {
    const std = @import("std");
    std.debug.print("{d}\n", .{add(3, 4)});
}

Build

Zig tem um sistema de build integrado e compilação cruzada.

zig
# zig build-exe main.zig
# zig run main.zig
02

Tipos

Inteiros

Zig tem inteiros de largura de bits arbitrária: i8, u8, i16, u16, i32, u32, etc.

zig
const a: u8 = 255;
const b: i32 = -100;
const c: usize = 0;

Arrays

[_] infere o comprimento do array.

zig
const arr = [_]i32{ 1, 2, 3, 4, 5 };
const first = arr[0];
const len = arr.len;

Slices

Slices são visões de arrays; .. é um fim exclusivo.

zig
const arr = [_]i32{ 1, 2, 3, 4, 5 };
const slice = arr[1..4]; // [2, 3, 4]

Optionals

?T é o tipo opcional; use .? ou if-let para desempacotar.

zig
var maybe: ?i32 = null;
maybe = 42;
if (maybe) |val| {
    // val is i32 here
}
03

Fluxo de Controle

If-Else

If-else são expressões em Zig.

zig
const x: i32 = 5;
if (x > 3) {
    // big
} else {
    // small
}

Switch

O switch precisa ser exaustivo.

zig
const x: u8 = 2;
switch (x) {
    1 => {},
    2 => {},
    else => {},
}

While

O : (i += 1) é a expressão de continue.

zig
var i: u32 = 0;
while (i < 5) : (i += 1) {
    // loop body
}

For

For itera sobre slices/arrays.

zig
const arr = [_]i32{ 1, 2, 3 };
for (arr) |val| {
    // use val
}
04

Memória

Allocators

Zig não tem alocações ocultas; os allocators são explícitos.

zig
const std = @import("std");
pub fn main() !void {
    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
    const allocator = gpa.allocator();
    const slice = try allocator.alloc(u8, 100);
    defer allocator.free(slice);
}

Defer

defer é executado ao sair do escopo — limpeza de recursos semelhante a RAII.

zig
const std = @import("std");
pub fn main() void {
    const file = std.fs.cwd().createFile("test.txt", .{}) catch unreachable;
    defer file.close();
}

Was this helpful?