---
title: string.find
summary: Возвращает начальную и конечную позиции совпадения, затем захваты шаблона; при отсутствии совпадения возвращает nil.
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"]
---
## Возвращаемое значение

| Тип | Значение |
| --- | --- |
| ([`number`](wiki:type-number), [`number`](wiki:type-number), ...) \| [`nil`](wiki:type-nil) | Тип описывает объявленный интерфейс, а не успешный игровой эффект. |

[Типы и методы](wiki:types)

## Параметры

| Имя | Тип |
| --- | --- |
| `text` | [`string`](wiki:type-string) |
| `pattern` | [`string`](wiki:type-string) |
| `start?` | [`number`](wiki:type-number) |
| `plain?` | [`boolean`](wiki:type-boolean) |

? обозначает необязательный аргумент, ... обозначает переменное количество аргументов. Недопустимый аргумент может вызвать ошибку Lua вместо возврата nil.

## Пример и контекст

```lua
local first, last = string.find("ship_name", "name", 1, true)
```

**Что произойдёт:** first = 6, last = 9. Индексы Lua начинаются с 1.

Этот фрагмент не печатает сообщение и не пишет его в журнал. Здесь указаны ожидаемые значения примера.

Смотрите [основы языка](wiki:x4-code-basics), [типы и методы](wiki:types) и [события Lua / MD](wiki:md-lua-bridge). Там приведены самостоятельные учебные примеры. Исходные файлы проектов и фрагменты их внутренней реализации в этом справочнике не распространяются.