---
title: ipairs
summary: Gibt einen Sequenziterator zurück, der bei Index 1 beginnt und am ersten Nullpunkt endet.
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

Gibt einen Sequenziterator zurück, der bei Index 1 beginnt und am ersten Nullpunkt endet.

## Rückgabewert

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

[Typen und Methoden](wiki:types)

## Parameter

| Name | Typ |
| --- | --- |
| `sequence` | [`table`](wiki:type-table) |

? 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
for index, value in ipairs({"a", "b"}) do
  local text = tostring(index) .. value
end
```

**Was geschieht:** Über zwei Iterationen wird die lokale Textvariable zu "1a" und "2b".

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.