string.match()

Enquanto o string.find() informa onde um padrão aparece em uma string, às vezes você precisa extrair o texto real que correspondeu. É aqui que o string.match() entra em cena, e ele se torna ainda mais poderoso quando combinado com capturas.

Capturas permitem que você marque partes específicas de um padrão que deseja extrair. Você cria uma captura envolvendo parte do seu padrão em parênteses (). Quando string.match() encontra uma correspondência, ele retorna o texto capturado em vez de apenas a posição.

Aqui está um exemplo simples de extração de um número de uma string:

local text = "Player score: 100"
local number = string.match(text, "%d+")
print(number)  -- Saída: 100

O padrão %d+ significa "um ou mais dígitos." O + é um modificador que corresponde a um ou mais da classe de caracteres precedente, permitindo que você capture números de vários dígitos.

Você pode usar capturas para extrair partes específicas de um padrão mais complexo:

local message = "User: Alice sent a message"
local username = string.match(message, "User: (%a+)")
print(username)  -- Saída: Alice

Aqui, os parênteses em volta de %a+ dizem ao Lua para capturar a sequência de letras que vem após "User: ". O restante do padrão ajuda a localizar a posição correta, mas apenas a parte capturada é retornada.

Se o seu padrão tiver múltiplas capturas, string.match() retorna todas elas como valores separados, que você pode atribuir a múltiplas variáveis de uma só vez.