$ sudo teach IT
Модуль 3 · Функции и ошибки · Урок 3.3

Ошибки и try

Вы научитесь возвращать ошибку из функции и обрабатывать её через catch или try.

Теория + практика~5 минутНовичок

Датчик шагомера иногда врёт: показывает миллион шагов за день. Пусть функция проверяет: больше 100000 — это сбой, и она вернёт ошибку, а не число.

Ошибка — тоже результат

Это очень просто: функция обещает вернуть «или число, или ошибку». Список возможных ошибок называется набором ошибок (error{...}), а запись ! перед типом означает «или ошибка, или значение». Zig не даст забыть про ошибку: число сначала нужно достать.

Достают двумя способами. catch: «если ошибка — подставь запасное значение или обработай её в блоке». try: «если ошибка — верни её вызывающему». Поэтому для try в main нужен тип !void.

Zig · steps.zig
const std = @import("std");

const StepError = error{TooMany};

fn checkSteps(n: u32) StepError!u32 {
    if (n > 100000) return error.TooMany;
    return n;
}

pub fn main() !void {
    const a = checkSteps(200000) catch 0;
    std.debug.print("С запасным значением: {d}\n", .{a});

    const b = try checkSteps(5000);
    std.debug.print("С try: {d}\n", .{b});

    const c = checkSteps(150000) catch |err| {
        std.debug.print("Сбой датчика: {}\n", .{err});
        return;
    };
    std.debug.print("Шагов: {d}\n", .{c});
}

Разбор по строкам

  • const StepError = error{TooMany}; — набор ошибок из одной: слишком много шагов.
  • StepError!u32 — результат функции: либо ошибка из набора, либо число u32.
  • return error.TooMany; — вернуть ошибку; обычный return n; возвращает число.
  • pub fn main() !void — main может вернуть ошибку.
  • catch 0 — при ошибке в a попадёт запасной 0.
  • try checkSteps(5000) — ошибки нет, в b попадёт 5000.
  • catch |err| { ... } — в err лежит сама ошибка; мы печатаем её и выходим из main через return.
Вывод
С запасным значением: 0
С try: 5000
Сбой датчика: error.TooMany

Частая ошибка: try в main с void

Если оставить pub fn main() void и написать try, Zig не соберёт программу: expected type 'void', found 'error{TooMany}'. Исправление — pub fn main() !void.

Попробуйте

Замените в последнем вызове 150000 на 7000: ошибки не будет, catch не сработает, и программа напечатает Шагов: 7000. А в первой строке замените catch 0 на catch 1 — запасным станет 1.

Если Zig установлен (https://ziglang.org/learn/getting-started/), сохраните код в файл steps.zig и запустите:

Терминал
zig run steps.zig

Что запомнить

  • StepError!u32 значит «или ошибка, или число»; ошибку возвращают через return error.TooMany.
  • catch подставляет запасное значение или обрабатывает ошибку в блоке |err|.
  • try отдаёт ошибку вызывающему, поэтому main должна быть !void.

В последнем уроке соберём всё в одну программу и посмотрим, куда идти дальше.

На следующий урок