---
title: ffi.cdef
summary: 声明FFI的C类型和签名;它不加载图书馆或实现函数.
section: reference
kind: api
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## 说明

声明FFI的C类型和签名;它不加载图书馆或实现函数.

## 返回值

| 类型 | 含义 |
| --- | --- |
| [`none`](wiki:type-results) | 类型描述了声明的界面,而不是证明成功的游戏效果. |

[类型与方法](wiki:types)

## 参数

| 名称 | 类型 |
| --- | --- |
| `declarations` | [`string`](wiki:type-string) |

没有什么. 标志着可选的参数;... 表示可变的参点数. 无效输入可能会导致Lua错误,而不是返回零.

## 示例与上下文

```lua
local ffi = require("ffi")
ffi.cdef("typedef struct { int count; } WikiExampleCounter;")
```

**运行效果：** 国际数据中心学习WikiExampleCounter类型,并使用其计数字段;没有分配任何实例.

这段段没有打印或写日志信息. 显示的值是示例的预期结果.

看到 [语言基础](wiki:x4-code-basics), [类型和方法](wiki:types) 和 [Lua / MD事件](wiki:md-lua-bridge). 其他独立学习的例子. 没有项目源文件或私人实施碎片被分配到此引用.