---
title: ffi.copy
summary: Kopiert Bytes in einen zugewiesenen Puffer. Das Weglassen der Länge erfordert einen Lua String und kopiert auch seinen Null-Terminator.
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"]
---
## Beschreibung

Kopiert Bytes in einen zugewiesenen Puffer. Das Weglassen der Länge erfordert einen Lua String und kopiert auch seinen Null-Terminator.

## Rückgabewert

| Typ | Bedeutung |
| --- | --- |
| [`none`](wiki:type-results) | Typen beschreiben die deklarierte Schnittstelle, nicht den Nachweis eines erfolgreichen Spieleffekts. |

[Typen und Methoden](wiki:types)

## Parameter

| Name | Typ |
| --- | --- |
| `destination` | [`cdata`](wiki:type-cdata) |
| `source` | [`string`](wiki:type-string) \| [`cdata`](wiki:type-cdata) |
| `length (optional only for string source)` | [`number`](wiki:type-number) |

? markiert ein optionales Argument; ... bedeutet eine variable Anzahl von Argumenten. Ungültige Eingaben können einen Lua-Fehler erhöhen, anstatt Null zurückzugeben.

## Beispiel und Kontext

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

**Was geschieht:** Puffer enthält die Bytes abc und einen Null-Terminator; die Funktion hat keine direkte Rückgabe.

Dieses Fragment gibt keine Protokollnachricht aus oder schreibt keine Protokollnachricht. Die angezeigten Werte sind die erwarteten Ergebnisse des Beispiels.

Siehe [Sprachkenntnisse](wiki:x4-code-basics), [Arten und Methoden](wiki:types) und [Lua / MD-Veranstaltungen](wiki:md-lua-bridge). Beispiele gibt es unabhängige Lernbeispiele. Mit dieser Referenz werden keine Projekt-Quelldateien oder private Implementierungsfragmente verteilt.