---
title: string - Строки
summary: Последовательность байтов. В Lua 5.1 длина #text измеряется в байтах; это не число символов UTF-8. Для соединения строк используется .. .
section: reference
kind: guide
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"]
---
## Значение

Последовательность байтов. В Lua 5.1 длина #text измеряется в байтах; это не число символов UTF-8. Для соединения строк используется .. .

## Пример

```lua
local text = "ship"
local upper = string.upper(text)
local same = text:upper()
local joined = text .. "_name"
```

**Что произойдёт:** upper = "SHIP", same = "SHIP", joined = "ship_name"; исходный text остаётся "ship".

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

## Методы и связанные вызовы


| Функция | Возвращает | Назначение |
| --- | --- | --- |
| [string.byte](wiki:api-standard-string-byte-281cf317) | [`number`](wiki:type-number), ... | Возвращает числовые значения байтов выбранного диапазона строки. |
| [string.char](wiki:api-standard-string-char-d6ca661d) | [`string`](wiki:type-string) | Создаёт строку из переданных числовых значений байтов. |
| [string.find](wiki:api-standard-string-find-f077b0bb) | ([`number`](wiki:type-number), [`number`](wiki:type-number), ...) \| [`nil`](wiki:type-nil) | Возвращает начальную и конечную позиции совпадения, затем захваты шаблона; при отсутствии совпадения возвращает nil. |
| [string.format](wiki:api-standard-string-format-6dd0b9fc) | [`string`](wiki:type-string) | Создаёт строку по шаблону форматирования и переданным значениям. |
| [string.gmatch](wiki:api-standard-string-gmatch-de045990) | [`function`](wiki:type-function) | Возвращает функцию-итератор совпадений Lua-шаблона. Lua-шаблоны не равны регулярным выражениям PCRE. |
| [string.lower](wiki:api-standard-string-lower-45da4911) | [`string`](wiki:type-string) | Возвращает копию строки в нижнем регистре. Это не универсальное преобразование регистра Unicode. |
| [string.rep](wiki:api-standard-string-rep-61de1e05) | [`string`](wiki:type-string) | Возвращает строку, повторённую заданное количество раз. |
| [string.upper](wiki:api-standard-string-upper-dde50125) | [`string`](wiki:type-string) | Возвращает копию строки в верхнем регистре. Это не универсальное преобразование регистра Unicode. |