string.gsub() para Substituição

Ao trabalhar com strings, muitas vezes você precisa localizar e substituir texto. A função string.gsub() do Lua facilita isso ao realizar uma substituição global: encontrar todas as ocorrências de um padrão e substituí-las por outra coisa.

A sintaxe básica recebe três argumentos: a string original, o padrão a ser encontrado e o texto de substituição:

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

Aqui está um exemplo simples que substitui todos os espaços por sublinhados:

local text = "hello world from lua"
local cleaned = string.gsub(text, " ", "_")
print(cleaned)  -- Saída: hello_world_from_lua

A função retorna dois valores: a string modificada e o número de substituições realizadas. Você pode capturar ambos, se necessário:

local result, count = string.gsub("foo bar foo", "foo", "baz")
print(result)  -- Saída: baz bar baz
print(count)   -- Saída: 2

Ao contrário de algumas funções de string que encontram apenas a primeira correspondência, string.gsub() substitui todas as ocorrências por padrão, tornando-a perfeita para tarefas de limpeza de texto, como remover caracteres indesejados ou padronizar a formatação.