Датчик шагомера иногда врёт: показывает миллион шагов за день. Пусть функция проверяет: больше 100000 — это сбой, и она вернёт ошибку, а не число.
Ошибка — тоже результат
Это очень просто: функция обещает вернуть «или число, или ошибку». Список возможных ошибок называется набором ошибок (error{...}), а запись ! перед типом означает «или ошибка, или значение». Zig не даст забыть про ошибку: число сначала нужно достать.
Достают двумя способами. catch: «если ошибка — подставь запасное значение или обработай её в блоке». try: «если ошибка — верни её вызывающему». Поэтому для try в main нужен тип !void.
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.
В последнем уроке соберём всё в одну программу и посмотрим, куда идти дальше.