string.gsub() для подстановки

При работе со строками часто требуется находить и заменять текст. Функция Lua string.gsub() упрощает эту задачу, выполняя глобальную замену: находя все вхождения шаблона и заменяя их чем-то другим.

Базовый синтаксис принимает три аргумента: исходную строку, шаблон для поиска и текст замены:

local result = string.gsub(originalString, pattern, replacement)

Вот простой пример, который заменяет все пробелы на символы подчёркивания:

local text = "hello world from lua"
local cleaned = string.gsub(text, " ", "_")
print(cleaned)  -- Вывод: hello_world_from_lua

Функция возвращает два значения: изменённую строку и количество выполненных замен. При необходимости можно получить оба значения:

local result, count = string.gsub("foo bar foo", "foo", "baz")
print(result)  -- Вывод: baz bar baz
print(count)   -- Вывод: 2

В отличие от некоторых функций для работы со строками, которые находят только первое совпадение, string.gsub() по умолчанию заменяет каждое вхождение, что делает её идеальной для задач очистки текста, таких как удаление нежелательных символов или стандартизация форматирования.