Zig Academy · 강의

오류 래핑과 다시 던지기

오류가 상위로 전달될 때 맥락을 추가합니다.

오류 래핑과 다시 던지기은(는) CoddyKit의 무료 Zig Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Zig Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Zig Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.

Errors Travel Upward

When a function cannot handle a failure itself, it passes the error to its caller. Along the way you can adjust or re-throw it.

Re-throw with try

The simplest re-throw is try. It forwards the original error unchanged to your caller, so the same value keeps bubbling up.

const data = try readFile(path);

Catch Then Return

To translate an error, catch it and return a different one. This swaps a low-level error for one that fits your own API.

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

Map Errors with switch

Combine catch with a switch to map each underlying error to a clearer one, while passing the rest through unchanged.

parse(s) catch |e| switch (e) {
    error.Empty => return error.NoInput,
    else => return e,
};

Zig Has No Stack Traces by Value

An error in Zig is just a tag, not an object holding context. To add detail you re-throw a more descriptive error of your own.

Attach Context Separately

Since the error tag carries no message, log the details where the failure happens, then return the higher-level error to the caller.

open(path) catch |e| {
    std.log.err("open {s}: {}", .{ path, e });
    return error.LoadFailed;
};

Widen the Error Set

If you return a new error, your function's error set must include it. An inferred !T set grows to cover everything you return.

fn load() !Config {
    return open(".cfg") catch error.LoadFailed;
}

Preserve or Replace

Decide per layer: forward the exact error with try, or replace it with one that makes more sense to your caller. Both are valid.

Keep Boundaries Clean

At a module boundary, map internal errors to a small public set. Callers then depend on stable names, not your internals.

Pair with errdefer

When you re-throw, any errdefer in scope still fires first. So you can rollback resources and translate the error in one path.

Meaningful Failures

Wrapping errors turns a raw cause into a message that fits your domain. The caller sees a clear error instead of an internal detail.

Quick Check

You want to replace a low-level error.NotFound with your own error.ConfigMissing for the caller. Which works?

Recap

You re-threw errors with try, mapped them via catch and switch, logged context, and widened error sets to keep failures meaningful. ✅

자주 묻는 질문

“오류 래핑과 다시 던지기” 강의는 무료인가요?

네 — “오류 래핑과 다시 던지기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Zig Academy 강의 전체를 잠금 해제할 수 있습니다. Zig Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“오류 래핑과 다시 던지기”에서 뭘 배우나요?

오류가 상위로 전달될 때 맥락을 추가합니다. 브라우저에서 직접 실행하는 실습 코드로 Zig Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Zig Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Zig Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“오류 래핑과 다시 던지기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Zig Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Zig Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Zig Academy(으)로 돌아가기