Noções básicas de FFI: ffi.cdef e ffi.load
Declare tipos C e carregue bibliotecas compartilhadas com o módulo ffi do LuaJIT.
Noções básicas de FFI: ffi.cdef e ffi.load é uma aula grátis de Lua Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Lua Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Lua Academy inclui 4 aulas no total.
O que é a FFI?
A FFI (Interface de Funções Externas) do LuaJIT permite chamar funções de bibliotecas C e usar estruturas de dados C diretamente do Lua, sem precisar escrever código de adaptação em C.
Carregando a FFI
Carregue a biblioteca FFI com require("ffi"). Ela vem integrada ao LuaJIT e não está disponível no PUC Lua padrão.
local ffi = require("ffi")ffi.cdef: declarando tipos C
ffi.cdef(cDeclarations) analisa declarações C e disponibiliza os tipos e as assinaturas de funções para a FFI. Nenhum código é compilado de fato — apenas informações de tipos.
ffi.cdef[[
int printf(const char *fmt, ...);
double sqrt(double x);
typedef struct { int x; int y; } Point;
]]ffi.load: carregando uma biblioteca compartilhada
ffi.load(libname) carrega uma biblioteca compartilhada e retorna um objeto cujos campos são as funções C declaradas.
local C = ffi.C -- access to libc on POSIX
local m = ffi.load("m") -- libm
print(m.sqrt(2.0)) -- 1.414...Acessando diretamente funções da libc
Em sistemas POSIX, ffi.C fornece acesso a todas as funções padrão da biblioteca C sem um carregamento explícito.
ffi.cdef[[ int puts(const char *s); ]]
ffi.C.puts("Hello from C!")Caminho de ffi.load
Passe o caminho completo ou o nome de uma biblioteca padrão. No Linux, use "m" para libm.so, "pthread" para pthreads e assim por diante.
Declarando estruturas
Declare estruturas C em cdef e, em seguida, aloque-as e acesse-as pelo Lua.
ffi.cdef[[
typedef struct { float x, y, z; } Vec3;
]]
local v = ffi.new("Vec3", {1, 2, 3})
print(v.x, v.y, v.z) -- 1.0 2.0 3.0Anotações e qualificadores de tipos
cdef aceita const, unsigned, int32_t, uint64_t e outros tipos padrão de C.
Várias chamadas a cdef
Você pode chamar ffi.cdef várias vezes. Declarações duplicadas são ignoradas. Normalmente, organize-as por biblioteca.
Diferenças entre plataformas
Os layouts de estruturas e as assinaturas de funções podem variar conforme a plataforma (Windows e Linux, 32 bits e 64 bits). Use ffi.os e ffi.arch para declarar condicionalmente as assinaturas corretas.
Nota de segurança
A FFI ignora a segurança de tipos do Lua. Declarações C incorretas causam corrupção de memória, falhas de segmentação ou comportamento indefinido. Sempre confira as declarações com o cabeçalho C real.
Pergunta sobre os fundamentos da FFI
O que ffi.cdef faz?
Recapitulação: fundamentos da FFI
Use ffi.cdef para declarar tipos e funções C e ffi.load para carregar bibliotecas compartilhadas. ffi.C fornece acesso direto à libc. Sempre verifique se as declarações correspondem aos cabeçalhos C reais para evitar corrupção de memória.
Aprenda Lua com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 40
- Aulas
- 159
Perguntas Frequentes
A aula “Noções básicas de FFI: ffi.cdef e ffi.load” é grátis?
Sim — o texto completo de “Noções básicas de FFI: ffi.cdef e ffi.load” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Lua Academy, atualize para CoddyKit PRO. O curso de Lua Academy inclui 4 aulas no total.
O que vou aprender em “Noções básicas de FFI: ffi.cdef e ffi.load”?
Declare tipos C e carregue bibliotecas compartilhadas com o módulo ffi do LuaJIT. Você pratica Lua Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Lua Academy?
Nenhuma experiência prévia é necessária. Lua Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Noções básicas de FFI: ffi.cdef e ffi.load”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Lua Academy?
Sim. Cada aula de Lua Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Noções básicas de FFI: ffi.cdef e ffi.load
- Chamando funções C via FFI
- Ponteiros, estruturas e matrizes em FFI
- Retornos de chamada: passando funções Lua para C