Listas dinâmicas com ArrayList
Aumente um buffer apoiado por um alocador.
Listas dinâmicas com ArrayList é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Zig Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Zig Academy inclui 4 aulas no total.
Um buffer expansível
Às vezes, você não sabe o tamanho antecipadamente. std.ArrayList é um vetor dinâmico que cresce à medida que você adiciona itens, usando um allocator. 📈
Ele é genérico
ArrayList é um tipo genérico: você informa o tipo do elemento uma vez e obtém uma lista exatamente desse tipo, com segurança de tipos completa.
const List = std.ArrayList(i32);Crie-o com init
Você cria uma lista com init, fornecendo o allocator que ela usará para crescer. O allocator permanece com a lista durante toda a sua vida útil.
var list = std.ArrayList(i32).init(allocator);Sempre use deinit
Uma lista é dona da memória do heap, portanto associe init a deinit para liberá-la. Um defer logo depois de init torna essa limpeza automática.
var list = std.ArrayList(i32).init(a);
defer list.deinit();Adicione itens
Adicione um elemento com append. Talvez seja necessário aumentar o buffer, portanto a operação pode falhar e, por isso, é chamada com try.
try list.append(7);Acesse os dados
O conteúdo atual fica na fatia .items. Você lê, indexa e percorre essa fatia como qualquer outra fatia de Zig.
for (list.items) |n| std.debug.print("{}\n", .{n});Comprimento e capacidade
O comprimento é list.items.len: quantos valores você armazenou. A capacidade é o espaço reservado, que pode ser maior para evitar crescimentos frequentes.
Reserve antecipadamente
Se souber aproximadamente o tamanho, chame ensureTotalCapacity primeiro. Reservar uma vez evita realocações repetidas à medida que a lista se enche.
try list.ensureTotalCapacity(100);Remova itens
Retire o último elemento com pop ou remova um elemento do meio pelo índice. A lista reduz seu comprimento, mas mantém sua capacidade.
const last = list.pop();Transfira a propriedade
Chame toOwnedSlice para retirar o buffer como uma fatia comum. A lista fica vazia, e você passa a ser responsável por liberá-lo.
const slice = try list.toOwnedSlice();Construído sobre o básico
ArrayList é apenas alloc, cópia e free feitos por você. Ele mostra até onde se pode chegar com allocators explícitos usando um tipo organizado e reutilizável. ✅
Verificação rápida
Relembre o que você precisa fazer quando um ArrayList deixar de ser usado.
Recapitulação
Você aprendeu que std.ArrayList cresce dinamicamente com um allocator: use init, append com try, leia .items e sempre use deinit ao terminar. 🎯
Perguntas Frequentes
A aula “Listas dinâmicas com ArrayList” é grátis?
Sim — o texto completo de “Listas dinâmicas com ArrayList” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Zig Academy, atualize para CoddyKit PRO. O curso de Zig Academy inclui 4 aulas no total.
O que vou aprender em “Listas dinâmicas com ArrayList”?
Aumente um buffer apoiado por um alocador. Você pratica Zig Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Zig Academy?
Nenhuma experiência prévia é necessária. Zig Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Listas dinâmicas com ArrayList”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Zig Academy?
Sim. Cada aula de Zig Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Por que Zig não tem alocações ocultas
- A interface de alocação
- alloc, free, create, destroy
- Listas dinâmicas com ArrayList