Patterns

[Ryzor 323]

Pattern

Pattern ("Padrão" em pt-br) é uma poderosa funcionalidade para manipulação de strings (caso você não saiba o que é uma "string", busque saber antes de continuar, recomendo também ter um certo domínio sobre a biblioteca string), e usada para buscar um padrão de texto pré-definido.

Porque aprender ?

Possui recursos indispensáveis quando se precisa trabalhar com strings, alta aplicabilidade em scripts direcionados a otserv (talkactions), não que se vá usar isso a todo o momento, mas é altamente recomendado que se saiba trabalhar com patterns, é extremamente útil as vezes.

Funções

Algumas funções da biblioteca padrão string que aceitam pattern em seus parâmetros:

string.find(

string

,

pattern

)

– Procura a primeira instância da pattern na string

string.gfind(

string

,

pattern

)

– Quando for chamada repetidamente, retorna cada instância da pattern na string

string.gsub(

string

,

pattern

,

replace

)

– Retorna uma string em que todas as instâncias da pattern foram substituidas por replace

string.match(

string

,

pattern

,

init

)

– Retorna uma lista de ocorrências da pattern na string, começando em init (1 significa o primeiro caractere da string, 2 o segundo, assim por diante)

Conjuntos

Quando se constrói uma pattern, se utiliza alguns caracteres, cada um representando um conjunto diferente:

x

(onde "x" não é um caractere mágico

^$()%.[]*+-?

)

→ Representa o caractere "x" mesmo;

.

→ Representa todos os caracteres;

%a

→ Representa todas as letras;

%c

→ Representa todos os caracteres de controle;

%d

→ Representa todos os dígitos;

%l

→ Representa todas as letras minusculas;

%p

→ Representa todos os caracteres de pontuação;

%s

→ Representa todos os caracteres de espaço;

%u

→ Representa todas as letras maiúsculas;

%w

→ Representa todos os caracteres alfanuméricos;

%x

→ Representa todos os dígitos hexadecimais;

%z

→ Representa o caractere com a representação do 0 (zero). Ao usar zeros na pattern ela não irá funciona, use esta nesse caso;

Ao usar letra maiúscula, isso faz representar o contrário (Exemplo:

%A

→ Representa tudo que não for letras;

%D

→ Representa tudo que não for um digito; assim por diante...).

Como dito anteriormente, para se criar uma pattern é necessário utilizar esses conjuntos, uma pattern é feita de uma sequência desses conjuntos. Se você quisesse criar uma pattern para encontrar uma certa string em um texto, por exemplo, para encontrar os números da string "23otserv", você teria que usar esta pattern "%d%dotserv", assim você estaria definindo que quer os numeros que estão ao lado da palavra ‘otserv’.

• Mas e se tivesse que encontrar um numero com 10 "casas" ?
  

Por isso existe os modificadores, para evitar essa repetição desnecessária.

Modificadores

Servem principalmente para poupar serviço e são quatro, entenda 'x' como sendo algum conjunto (%a, %c, %d, ...):

x

*

→ Retorna 0 ou mais repetições do conjunto x. Sempre retornará a maior cadeia possível encontrada;

x

+

→ Retorna 1 ou mais repetições do conjunto x. Sempre retornará a maior cadeia possível encontrada;

x

-

→ Retorna 0 ou mais repetições do conjunto x. Sempre retornará a menor cadeia possível encontrada;

x

?

→ Retorna 0 ou 1 ocorrência de x;

Elementos especiais

Existe também quatro elementos especiais:

%n

→ Sendo n um numero entre 1 e 9, busca a enésima captura (apenas vi sendo usada na função string.gsub);

%bxy

→ Procura uma string que inicia com x e termina com y;

^

→ Quando está no começo da pattern, força a pattern a ser encontrada no começo da string;

$

→ Quando está no final da pattern, força a pattern a ser encontrada no fim da string;

Nota: Se ^ ou $ estiverem em outros lugares da pattern, não fazem nada, apenas representam eles mesmos.

Construindo uma pattern

Vamos construir algumas patterns com os elementos citados acima.

Primeiro alguns exemplos e depois uma explicação mais detalhada de cada elemento da pattern:

String para as patterns: "Exemplo lua de pattern lua feito em lua"

exemplos toscos, a gente se vê por aqui

Pattern:

(%a+)

lua

Capturaria:

Exemplo

lua

de pattern lua feito em lua

Ele só retornará o primeiro caso que corresponder com a pattern.

Agora, ao invés de usar o "%a" fosse usado o "." (que captura tudo), aconteceria isso:

Pattern:

(.+)

lua

Capturaria:

Exemplo lua de pattern lua feito em

lua

Como "%a" captura apenas letras e não o "espaço", foi por isso que no primeiro exemplo só capturou a palavra "Exemplo" e no segundo exemplo, como foi usado o "." que captura tudo, capturou uma parte maior (ai que vêm a parte do modificador) por causa do modificador "+" que sempre vai buscar a maior cadeia possivel, agora veja um exemplo usando o "-":

Pattern:

(.-)

lua

Capturaria:

Exemplo

lua

de pattern lua feito em lua

O modificador "-", como dito anteriormente, captura a menor cadeia e por isso capturaria apenas o "Exemplo".

Todos os modificadores são importantes.

Um exemplo maior:

Pattern:

(%a+)

lua

(.-)

lua

(.+)

Capturaria:

Exemplo

lua

de pattern

lua

feito em lua

Para quem não entendeu

Explicação passo a passo:

(

%d

+

)

Captura → O parenteses define que você quer que retorne essa captura.

Conjunto → No caso é o de digitos.

Modificador → No caso mostra que é para obter a maior cadeia possivel com 1 ou mais repetições do conjunto.

Um exemplo mais avançado

Agora usando de exemplo a pattern da função string.trim, que remove os espaços em branco do lado esquerdo e direito da string.

Código:

function string.trim(str)

-- Function by Colandus

return (string.gsub(str, "^%s*(.-)%s*$", "%1"))

end

string.gsub(

str

, "

^

%s*

(.-)

%s*

$

", "

%1

")

str → Uma string qualquer;

^ → Força o começo da pattern ser encontrada no começo de str;

%s* → Conjunto de espaços, podendo ter 0 ou mais repetições;

(.-) → A captura principal, a que vai ser retornada, podendo ser digitos, letras, espaço, etc;

$ → Força o final da pattern ser encontrada no fim de str;

%1 → Retorna a 1ª captura da pattern e usa como parametro da função (Esse é um dos elementos especiais, %n);Dessa forma será removido os espaços apenas no começo e no fim da string !

Complemento

Depois de dominar e entender como funciona as patterns, vamos aplica-las em funções, vou mostrar um exemplo de cada função (as que foram citadas no começo).

string.find:

Código:

init, end, case1, case2 = string.find("minha string123", "(%a+) (.+)")

init

→ Onde inicia a captura encontrada (

nesse caso, init = 1

);

end

→ Onde termina a captura encontrada (

end = 15

);

case1

→ Primeira captura que equivale a pattern (%a+) (

case1 = minha

);

case2

→ Segunda captura que equivale a pattern (.+) (

case2 = string123

);

string.gfind:

Código:

for occ in string.gfind("a1a2a3a4a5", "(%a%d)") do

print(occ)

end

occ

→ Terá um valor para cada instância da pattern (%a%d) encontrada, então irá printar a1, a2, a3, a4 e a5.

string.match:

Código:

case1, case2 = string.match("Eu tenho 50 reais", "(%d+) (%a+)")

case1

→ Primeira captura que equivale a pattern (%d+) (

case1 = 50

);

case2

→ Segunda captura que equivale a pattern (%a+) (

case2 = reais

);

Referência

http://www.lua.org/manual/5.1/pt/manual.html#5.4.1

http://lua-users.org/wiki/PatternsTutorial

Então é isso, espero ter sido o mais claro possivel,

Qualquer dúvida, erro ou sugestão, poste !

Creditos

Lwkass

[Flamer 115]

Muito bom o conteúdo para quem está fazendo scripts em Lua. Bastante completo.

Editado Novembro 29, 2012 por Flamer (veja o histórico de edições)