Компиляция объектного файла и запуск программы Crystal, как и раньше, выведет: Время летнего времени: 14.
Еще одна распространенная функция привязки C — поддержка обратных вызовов. Crystal, эквивалентный указателю на функцию C, — это Proc. Лучше всего это показать на примере. Давайте напишем функцию C, которая принимает обратный вызов, принимающий целочисленное значение. Функция C сгенерирует случайное число, а затем вызовет обратный вызов с этим значением. В конечном итоге это может выглядеть примерно так:
#include <stdlib.h>
#include <time.h>
void number_callback(void (*callback)(int))
{
srand(time(0));
return (*callback)(rand());
}
Привязки Crystal будут выглядеть так:
@[Link(ldflags: "#{__DIR__}/callback.o")]
lib LibCallback
fun number_callback(callback : LibC::Int -> Void) : Void
end
LibCallback.number_callback ->(value) { puts "Generated: #{value}" }
В этом примере мы передаем Proc(LibC::Int, Nil) в качестве значения аргумента обратного вызова C. Обычно вам нужно будет ввести значение аргумента Proc. Однако, поскольку мы передаем Proc напрямую, компилятор может определить его на основе типа привязанного развлечения и ввести его за нас. Тип обязателен, если мы сначала присвоили его переменной, например callback = ->(value : LibC::Int) { ... }.
Обратный вызов напечатает, какое случайное значение сгенерировал код C. Помните: прежде чем мы сможем запустить код Crystal, нам нужно скомпилировать код C в объектный файл с помощью этой команды: gcc -Wall -O3 -march=native -c callback.c -o callback.o. После этого вы можете свободно запускать код Crystal несколько раз и утверждать, что он каждый раз генерирует новое число.
Хотя мы можем передавать Procs как функцию обратного вызова, вы не можете передать замыкание, например, если вы попытались сослаться на переменную, определенную вне Proc внутри него. Например, если мы хотим умножить сгенерированное значение C на некоторый множитель:
multiplier = 5
LibCallback.number_callback ->(value : LibC::Int) { puts
value * multiplier }
Выполнение этого приведет к ошибке времени компиляции: Ошибка: невозможно отправить замыкание в функцию C (замыкающие переменные: множитель).
Передача замыкания возможна, но это немного сложнее. Я бы предложил проверить этот пример в документации Crystal API: https://crystal-lang.org/api/Proc.html#passing-a-proc-to-a-c-function. Как упоминалось ранее, привязки C могут быть отличным способом использования уже существующего кода C. Теперь, когда вы знаете, как подключаться к библиотеке, писать привязки и использовать их в Crystal, вы можете фактически использовать код библиотеки C. Далее перейдем к написанию привязок для libnotify.
Привязка libnotify
Одним из преимуществ написания привязок C в Crystal является то, что вам нужно привязывать только то, что вам нужно. Другими словами, нам не нужно полностью привязывать libnotify, если мы собираемся использовать лишь небольшую его часть. На самом деле нам нужны всего четыре функции:
• notify_init – используется для инициализации libnotify.
• notify_uninit — используется для деинициализации libnotify.
• notify_notification_new — используется для создания нового уведомления.
• notify_notification_show – используется для отображения объекта уведомления.
В дополнение к этим методам нам также необходимо определить одну структуру NotifyNotification, которая представляет собой отображаемое уведомление.
Я определил это, просмотрев файлы *.h libnotify на GitHub: https://github.com/GNOME/libnotify/blob/master/libnotify. HTML-документация Libnotify также включена в папку этой главы на GitHub, и ее можно использовать в качестве дополнительной справки.
Основываясь на информации из их документации, исходном коде и том, что мы узнали в последнем разделе, привязки, которые нам нужны для libnotify, будут выглядеть следующим образом:
@[Link("libnotify")]
lib LibNotify
alias GInt = LibC::Int
alias GBool = GInt
alias GChar = LibC::Char
type NotifyNotification = Void*
fun notify_init(app_name : LibC::Char*) : GBool
fun notify_uninit : Void
fun notify_notification_new(summary : GChar*, body :
GChar*, icon : GChar*) : NotifyNotification*
fun notify_notification_show(notification :
NotifyNotification*, error : Void**) : GBool
fun notify_notification_update(notification :
NotifyNotification*, summary : GChar*, body : Gchar*, icon : GChar*) : GBool
end
Обратите внимание: в отличие от других случаев, мы можем просто передать “libnotify” в качестве аргумента аннотации Link. Мы можем это сделать, поскольку соответствующая библиотека уже установлена в масштабе всей системы, а не является созданным нами специальным файлом.