Lua Academy · Lekcja

Callbacki: przekazywanie funkcji Lua do C

Proszę używać ffi.cast do tworzenia callbacków C, które wywołują kod Lua.

Callbacki: przekazywanie funkcji Lua do C to bezpłatna lekcja Lua Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Lua Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Lua Academy zawiera 4 lekcji w sumie.

Czym są callbacki C?

Niektóre interfejsy API C wymagają przekazania wskaźnika do funkcji, którą kod C wywoła później. ffi.cast FFI pozwala tworzyć zgodne z C wskaźniki do funkcji na podstawie funkcji Lua.

Deklarowanie typu callbacku

Najpierw należy zadeklarować typ wskaźnika do funkcji w cdef.

local ffi = require("ffi")
ffi.cdef[[
  typedef void (*callback_t)(int event, void *data);
  void register_handler(callback_t cb);
]]

Tworzenie callbacku

Za pomocą ffi.cast("callback_t", luaFunc) można opakować funkcję Lua jako callback C. Wynikiem jest wskaźnik do funkcji C, który można przekazać do kodu C.

local function myHandler(event, data)
  print("Event:", event)
end
local cb = ffi.cast("callback_t", myHandler)
lib.register_handler(cb)

Cykl życia callbacku

Należy zachować referencję Lua do obiektu callbacku (cb). Jeśli zostanie on usunięty przez GC, wywołanie wskaźnika do funkcji C spowoduje awarię. Obiekt należy przechowywać w długo żyjącej zmiennej lub tabeli.

local callbacks = {}  -- prevent GC
callbacks[#callbacks+1] = ffi.cast("callback_t", myHandler)
lib.register_handler(callbacks[#callbacks])

Sortowanie za pomocą komparatora C

Komparator Lua należy przekazać do funkcji C qsort za pomocą callbacku FFI.

ffi.cdef[[
  typedef int (*cmp_t)(const void *a, const void *b);
  void qsort(void *base, size_t nmemb, size_t size, cmp_t cmp);
]]
local arr = ffi.new("int[5]", {3,1,4,1,5})
local cmp = ffi.cast("cmp_t", function(a, b)
  return ffi.cast("int*", a)[0] - ffi.cast("int*", b)[0]
end)
ffi.C.qsort(arr, 5, ffi.sizeof("int"), cmp)
for i = 0, 4 do io.write(arr[i] .. " ") end

Callbacki i korutyny

Callbacki Lua wywoływane z C nie mogą zawieszać wykonania (wywoływać coroutine.yield). Warstwa C nie obsługuje przełączania korutyn Lua. Callbacki należy projektować tak, aby nie zawieszały wykonania.

Upvalue w callbackach

Callbacki Lua mogą normalnie przechwytywać upvalue. Dzięki temu callbacki mogą uzyskiwać dostęp do kontekstu (np. obiektu lub tabeli stanu) bez używania zmiennych globalnych.

local function makeHandler(ctx)
  return ffi.cast("callback_t", function(event, _)
    ctx.lastEvent = event  -- upvalue access
  end)
end

Procedury obsługi sygnałów

Za pomocą FFI można rejestrować funkcje Lua jako procedury obsługi sygnałów Unix. Należy zachować ostrożność: procedury obsługi sygnałów mają poważne ograniczenia dotyczące wywoływanych funkcji C.

Zarządzanie pamięcią callbacków

Po wyrejestrowaniu callbacku po stronie C należy zwolnić go za pomocą cb:free(). Wycieki obiektów callbacków marnują pamięć.

Alternatywa: funkcje opakowujące w C

W przypadku złożonych integracji cienka warstwa pośrednia w C może być przejrzystsza niż callbacki FFI. Warstwa ta wywołuje Lua za pośrednictwem API C, zapewniając pełną kontrolę nad korutynami i obsługą błędów.

Wydajność

Callbacki FFI są szybkie, ale nie tak szybkie jak bezpośrednie wywołania FFI, ponieważ most C–Lua wiąże się z narzutem konfiguracyjnym. W przypadku callbacków o bardzo dużej częstotliwości (np. audio) warto rozważyć implementacje w całości w C.

Pytanie dotyczące callbacków

Dlaczego należy przechowywać referencję Lua do obiektu callbacku FFI?

Podsumowanie: callbacki FFI

Użyj ffi.cast("fn_ptr_type", luaFunc), aby utworzyć callbacki zgodne z C. Zawsze przechowuj referencję, aby zapobiec usunięciu obiektu przez GC. Callbacki nie mogą wywoływać yield. Używaj upvalues, aby przekazywać kontekst do callbacków.

Często zadawane pytania

Czy lekcja „Callbacki: przekazywanie funkcji Lua do C” jest bezpłatna?

Tak — pełny tekst „Callbacki: przekazywanie funkcji Lua do C” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Lua Academy, przejdź na CoddyKit PRO. Kurs Lua Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Callbacki: przekazywanie funkcji Lua do C”?

Proszę używać ffi.cast do tworzenia callbacków C, które wywołują kod Lua. Ćwiczysz Lua Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Lua Academy?

Nie wymagamy żadnego doświadczenia. Lua Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Callbacki: przekazywanie funkcji Lua do C”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Lua Academy?

Tak. Każda lekcja Lua Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Podstawy FFI: ffi.cdef i ffi.load
Wywoływanie funkcji C przez FFI
Wskaźniki, struktury i tablice w FFI
Callbacki: przekazywanie funkcji Lua do C

← Powrót do Lua Academy