Zig Academy · Aula

Propagando falhas com try

Propague erros para cima com uma única palavra-chave.

Aula 3 de 413 etapas

Propagando falhas com try é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 3 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.

O tratamento fica repetitivo

Escrever um if-else em torno de cada chamada que pode falhar para encaminhar o erro fica rapidamente excessivo. Zig oferece um atalho: a palavra-chave try.

try desembrulha ou retorna

Coloque try antes de uma chamada que pode falhar. Em caso de sucesso, ele entrega o valor; em caso de erro, retorna esse erro da função atual.

const n = try parse(input);

É apenas uma abreviação

Essa linha é exatamente igual a capturar o erro e retorná-lo você mesmo. try apenas escreve o código repetitivo por você.

const n = parse(input) catch |e| return e;

Sua função também precisa poder falhar

Como try pode retornar um erro, a função envolvente precisa ter um tipo de retorno que seja uma união de erros. Caso contrário, o compilador rejeitará o código.

fn run() !void {
    const n = try parse(input);
}

Encadeie vários try

Coloque várias chamadas try em sequência. Cada uma interrompe a função imediatamente em caso de falha, de modo que o caminho de sucesso seja lido de cima para baixo.

const f = try open(path);
const data = try read(f);

try no meio de expressões

Você pode colocar try diretamente dentro de uma expressão maior. O valor desembrulhado segue direto para a chamada ou operação matemática ao redor.

const total = base + try parse(input);

try com chamadas void

Mesmo quando uma chamada retorna !void, use try para encaminhar qualquer falha. Você não recebe nenhum valor, apenas o retorno antecipado em caso de erro.

try file.writeAll(data);

Os erros sobem pela pilha

Com try em cada camada, uma falha profunda se propaga até o topo, até que alguma função chamadora finalmente decida tratá-la.

Caminho de sucesso legível

A grande vantagem é a clareza: o encaminhamento de erros se resume a uma única palavra-chave, mantendo a lógica principal em primeiro plano.

try não trata erros

Lembre-se de que try apenas encaminha um erro; ele nunca o recupera. Para reagir localmente, use catch.

Quando encaminhar

Use try quando a decisão correta for deixar quem chama lidar com a falha. A maioria das funções intermediárias simplesmente passa os erros adiante.

Verificação rápida

Você escreve try doThing() dentro de uma função. O que acontece se doThing retornar um erro?

Responda na aula interativa

Recapitulação

Você aprendeu que try desembrulha o valor em caso de sucesso e retorna o erro caso contrário. É uma abreviação para capturar e encaminhar, mantendo o código limpo. ✅

Grátis para começar

Aprenda Zig com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos: 30
Aulas: 120

Começar a aprender grátis Ver o curso completo

Perguntas Frequentes

A aula “Propagando falhas com try” é grátis?

Sim — o texto completo de “Propagando falhas com try” é 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 “Propagando falhas com try”?

Propague erros para cima com uma única palavra-chave. 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 3 de 4.

Quanto tempo leva a aula “Propagando falhas com try”?

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

← Voltar para Zig Academy