Zig Academy · Aula

Recuperando-se com catch

Forneça uma alternativa quando ocorrer um erro.

Recuperando-se com catch é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 1 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.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Errors Need a Plan

A function can return an error union like !u32. Before you use the result you must decide what happens on the failure path.

Meet catch

The catch operator turns an error union into a plain value by giving a fallback to use whenever the call returns an error.

const n = parse(text) catch 0;

The Fallback Replaces the Error

If the call succeeds you get the real value. If it errors you get the right side of catch instead, so n is always a usable number.

const n = parse(text) catch -1;

catch Is an Expression

Because catch yields a value, you can drop it inline anywhere a value is expected, like straight into a function argument.

print(parse(text) catch 0);

Capture the Error

Add a pipe capture to inspect what went wrong. The name inside the bars holds the specific error value that was returned.

const n = parse(text) catch |err| {
    log(err);
    return 0;
};

catch Can Run a Block

The right side of catch may be a whole block. Use it to log, compute a fallback, or break out of a loop before continuing.

const v = open(path) catch |e| blk: {
    break :blk fallback;
};

catch Can Return Early

You can return from inside catch to leave the function when recovery is impossible. The code after it never runs on error.

const f = open(path) catch return error.MissingFile;

catch unreachable

Writing catch unreachable asserts the call cannot fail. In a safe build a real error here panics instead of being ignored.

const n = parse("42") catch unreachable;

Use unreachable Carefully

Reach for catch unreachable only when an error is truly impossible. If you are unsure, supply a real fallback instead.

catch vs try

Use catch when you can handle the error here and now. Use try when you would rather pass the error up to the caller.

Recovery Is Explicit

Every error union forces a choice, so a failure can never be silently dropped. With catch you decide exactly how to recover.

Quick Check

You want to keep going with a safe default when a call fails. Which expression fits?

Recap

You used catch to recover from errors with a fallback, a block, an early return, or an assertion. Failure is always handled on purpose. ✅

Perguntas Frequentes

A aula “Recuperando-se com catch” é grátis?

Sim — o texto completo de “Recuperando-se com catch” é 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 “Recuperando-se com catch”?

Forneça uma alternativa quando ocorrer um erro. 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 1 de 4.

Quanto tempo leva a aula “Recuperando-se com catch”?

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