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

Свои функции

Вы напишете собственную функцию с параметрами и результатом и вызовете её из main.

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

Мы уже печатали, считали и перебирали дни, но весь код лежал в одной main. Пора выносить повторяющиеся действия в свои функции.

Функция: рецепт с именем

Функция — это рецепт с именем: вы один раз описываете, что делать, а потом просто зовёте по имени. На входе у рецепта параметры (что дали), на выходе результат (что получили обратно). У каждого параметра и у результата обязательно указывается тип. Слово return отдаёт результат. Уже знакомая main — тоже функция, а pub перед ней значит «видна снаружи»: так программу находит Zig. Свои функции пишутся выше main без pub.

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

fn percent(steps: u32, goal: u32) u32 {
    return steps * 100 / goal;
}

fn showDay(n: u32, steps: u32) void {
    std.debug.print("День {d}: {d} шагов\n", .{ n, steps });
}

pub fn main() void {
    const goal: u32 = 10000;
    showDay(1, 8000);
    std.debug.print("Это {d}% цели\n", .{percent(8000, goal)});
    std.debug.print("А 12000 шагов - это {d}%\n", .{percent(12000, goal)});
}

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

  • fn percent(steps: u32, goal: u32) u32 — fn, имя, параметры с типами в скобках и тип результата u32 перед телом.
  • return steps * 100 / goal; — считаем процент и отдаём наружу; для 8000 и 10000 выйдет 80.
  • fn showDay(n: u32, steps: u32) void — void значит «ничего не возвращаю»: функция только печатает, return не нужен.
  • showDay(1, 8000); — вызов: значения идут в параметры по порядку.
  • percent(8000, goal) — вызов внутри печати: результат подставится в {d}.
Вывод
День 1: 8000 шагов
Это 80% цели
А 12000 шагов - это 120%

Частая ошибка: менять параметр

Параметры — константы. Строка steps += 500; внутри функции даст ошибку сборки cannot assign to constant. Нужно новое значение — заведите var внутри функции или просто верните результат выражения.

Попробуйте

Замените вызов percent(12000, goal) на percent(5000, goal) — в выводе будет 50%. Допишите ещё один вызов showDay(2, 12000); и получите вторую строку с днём. А если убрать из percent слово return, Zig откажется собирать программу.

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

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

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

  • Функция: fn имя(параметр: тип) тип_результата { ... }; результат отдаёт return.
  • Если результата нет, тип — void; вызывают функцию по имени: percent(8000, goal).
  • Параметры внутри функции менять нельзя: они константы.

Чтобы отдать в функцию сразу несколько дней недели, понадобятся срезы — они в следующем уроке.

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