Вызов функций C и компоновка

@cImport предоставляет объявления, но настоящий машинный код по-прежнему находится в библиотеке C, с которой необходимо выполнить компоновку.

Большинству вызовов C нужна стандартная библиотека C. Укажите системе сборки выполнить компоновку с libc, чтобы такие функции, как printf, разрешились во время компоновки.

Для быстрого запуска передайте флаг самостоятельно. -lc подключает libc, когда вы напрямую компилируете отдельный файл.

После компоновки функция C вызывается так же, как функция Zig. Вы пишете c.printf(...), а Zig обрабатывает соглашение о вызовах.

Необходимо передавать аргументы, соответствующие C-сигнатуре. Неверные типы вызывают ошибку компиляции, поскольку Zig знает переведённый прототип.

Для других библиотек укажите их имя. linkSystemLibrary сообщает компоновщику, что нужно подключить, например, математическую библиотеку.

Возвращаемое значение функции C поступает как обычное значение Zig переведённого типа, готовое к сохранению или проверке.

В C нет объединений ошибок, поэтому сбои проявляются как коды возврата или установленное значение errno. Проверять их нужно вручную, по правилам C.

Zig не выполняет бесшумное преобразование ваших данных. C получает именно то, что вы передали, поэтому вызов остаётся быстрым и предсказуемым.

В build.zig вы добавляете параметры компоновки к артефакту. Тот же шаг exe, который компилирует код, также записывает сведения о его библиотеках.

Вызов C всегда состоит из импорта и компоновки: сначала подключите объявления, затем убедитесь, что настоящие символы доступны компоновщику.

Подумайте, что позволяет компоновщику действительно разрешить функцию C.

Вы узнали, что для вызова C нужны и импорт, и компоновка, после чего функции C вызываются так же, как обычные функции Zig. 🎯