string.find()

A função string.find() é uma ferramenta poderosa para fazer buscas em strings. Ela permite procurar uma string menor (chamada de padrão) dentro de uma string maior e informa exatamente onde ela foi encontrada.

Aqui está a sintaxe básica:

string.find(text, pattern)

Quando string.find() localiza o padrão com sucesso, retorna dois números: a posição inicial e a posição final da correspondência. Se o padrão não for encontrado, retorna nil.

Aqui está um exemplo simples:

local sentence = "The treasure is hidden here"
local start_pos, end_pos = string.find(sentence, "treasure")
print(start_pos, end_pos)  -- exibe: 5 12

Neste exemplo, a palavra "tesouro" começa na posição 5 e termina na posição 12 da frase.

Uma coisa que você precisa saber: o texto que você procura é um padrão, não texto simples. Alguns caracteres têm significados especiais nos padrões: . % - + * ? [ ] ^ $ ( ). Você vai aprendê-los mais adiante no curso. Letras, dígitos e espaços correspondem a si mesmos, como no exemplo acima, mas um caractere especial pode corresponder a mais do que você queria:

print(string.find("Score: 105", "1.5"))  -- exibe: 8 10 (o . correspondeu ao 0)

Para pesquisar o texto exatamente como está escrito, adicione mais dois argumentos: 1 (começar no primeiro caractere) e true (uma pesquisa simples, sem caracteres especiais):

print(string.find("Score: 105", "1.5", 1, true))   -- exibe: nil
print(string.find("Version 1.5", "1.5", 1, true))  -- exibe: 9 11