---
title: string.find
summary: Devuelve posiciones de inicio/final de coincidencia seguidas de capturas de patrón, o nil cuando no tiene igual.
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"]
---
## Descripción

Devuelve posiciones de inicio/final de coincidencia seguidas de capturas de patrón, o nil cuando no tiene igual.

## Valor devuelto

| Tipo | Significado |
| --- | --- |
| ([`number`](wiki:type-number), [`number`](wiki:type-number), ...) \| [`nil`](wiki:type-nil) | Tipos describen la interfaz declarada, no prueba de un efecto de juego exitoso. |

[Tipos y métodos](wiki:types)

## Parámetros

| Nombre | Tipo |
| --- | --- |
| `text` | [`string`](wiki:type-string) |
| `pattern` | [`string`](wiki:type-string) |
| `start?` | [`number`](wiki:type-number) |
| `plain?` | [`boolean`](wiki:type-boolean) |

? marca un argumento opcional; ... significa un número variable de argumentos. La entrada no válida puede generar un error Lua en lugar de devolver nil.

## Ejemplo y contexto

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

**Qué ocurre:** primero = 6, último = 9; los índices Lua comienzan en 1.

Este fragmento no imprime ni escribe un mensaje de registro. Los valores mostrados son los resultados esperados del ejemplo.

Ver [conceptos básicos del idioma](wiki:x4-code-basics), [tipos y métodos](wiki:types) y [Eventos Lua / MD](wiki:md-lua-bridge). Ejemplos de aprendizaje independiente son ejemplos. No se distribuyen archivos de fuentes de proyectos o fragmentos de implementación privada con esta referencia.