---
title: ffi.copy
summary: 复制字节到分配缓冲中. 输出长度需要一个Lua字符串,同时还复制其零终端符.
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"]
---
## 说明

复制字节到分配缓冲中. 输出长度需要一个Lua字符串,同时还复制其零终端符.

## 返回值

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

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

## 参数

| 名称 | 类型 |
| --- | --- |
| `destination` | [`cdata`](wiki:type-cdata) |
| `source` | [`string`](wiki:type-string) \| [`cdata`](wiki:type-cdata) |
| `length (optional only for string source)` | [`number`](wiki:type-number) |

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

## 示例与上下文

```lua
local ffi = require("ffi")
local buffer = ffi.new("char[4]")
ffi.copy(buffer, "abc")
```

**运行效果：** 缓冲包含字节 abc 和零终结器;函数没有直接返回.

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

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