---
title: string.gmatch
summary: Gibt einen Lua-Muster-Match-Iterator zurück; Lua-Muster unterscheiden sich von PCRE-Normalausdrücken.
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 Lua-Muster-Match-Iterator zurück; Lua-Muster unterscheiden sich von PCRE-Normalausdrücken.

## Rückgabewert

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

[Typen und Methoden](wiki:types)

## Parameter

| Name | Typ |
| --- | --- |
| `text` | [`string`](wiki:type-string) |
| `pattern` | [`string`](wiki:type-string) |

? 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 word in string.gmatch("ship station", "%a+") do
  local upper = string.upper(word)
end
```

**Was geschieht:** Der Iterator liefert "Schiff" und "Station", oben wird "SHIP" und "STATION".

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.