# O Manual do Editor de Expressões Regulares

## Introdução

O editor de expressões regulares é um editor para criar uma expressão regular de uma forma gráfica (em contraste com a sintaxe em ASCII). Tradicionalmente, as expressões regulares têm sido escritas com a sintaxe de ASCII, a qual se assemelha, por exemplo, a `^.*kde\b`. A maior desvantagem deste estilo é:

- É difícil de compreender pelos não-programadores.

- Obriga a que você escape ou comente alguns símbolos (para corresponder com um asterisco, por exemplo, você tem de escrever `\*`).

- Obriga a que você se recorde das regras para a precedência (A que é que corresponde o `x|y*`? A um único `x` ou um conjunto de `y`s, OU, por sua vez, um conjunto de `x`s e `y`s misturados?)

O editor de expressões regulares, por outro lado, permite-lhe desenhar a sua expressão regular de uma forma não-ambígua. O editor resolve, pelo menos, os itens 2 e 3 descritos acima. Pode não tornar as expressões regulares disponíveis para os não-programadores, ainda que só os testes pelos utilizadores possam confirmar isso. Por isso, se você for um não-programador e tiver ganho o poder das expressões regulares com este editor, então comunique-me esse facto.

## O Que é Uma Expressão Regular

A expressão regular é uma forma de indicar as condições a cumprir para uma dada situação em mente. Normalmente, quando você procura num editor de texto, você indica o texto a procurar literalmente; se usar expressões regulares, por outro lado, você diz como é que uma ocorrência se poderá parecer. Alguns exemplos disto incluem Estou à procura da palavra KDE, mas só no início da linha ou Estou à procura da palavra `a`, mas tem de existir isolada ou ainda Estou à procura dos ficheiros que comecem pela palavra `teste`, seguida de um conjunto de algarismos, como por exemplo `teste12`, `teste107` e `teste007`

Você constrói as expressões regulares a partir de sub-expressões, tal como você constrói os brinquedos grandes de Lego a partir de peças mais pequenas. Tal como no mundo do Lego, também existe um conjunto de peças básicas. A seguir será descrita cada uma dessas "peças de construção" usando um conjunto de exemplos.

### Procurar por texto normal.

Se você quiser procurar apenas um dado texto, então a expressão regular não é de facto a melhor escolha. A razão para tal é que as expressões regulares atribuem um significado especial a alguns caracteres. Isto inclui os seguintes caracteres: `.*|$`. Por isso, se quiser procurar pelo texto `kde.` (i.e. os caracteres `kde` seguidos de um ponto), então você teria de indicar isto assim: `kde\.`

O editor de expressões regulares resolve este problema ao tratar das regras de escape por si.

Se escrever `\.` em vez de `.` é chamado de escape.

### Correspondência com URL's

Quando você selecciona algo que se assemelha a um URL no KDE, aí o programa `klipper` oferecer-se-á para iniciar o `konqueror` com o URL seleccionado.

O `Klipper` faz isto ao fazer uma correspondência do texto seleccionado ou da área de transferência com várias expressões regulares diferentes; quando uma das expressões regulares fizer correspondência, o comando correspondente será despoletado.

A expressão regular para os URLs diz (entre outras coisas), que o texto deverá começar por `http://`. Isto é descrito com base nas expressões regulares antecedendo o texto `http://` com um acento circunflexo (o carácter `^`).

O exemplo acima serve para marcar as posições com expressões regulares. De forma semelhante, a posição do fim de linha poderá ser correspondida com o `$` (i.e., um símbolo de cifrão).

### Se procurar pela palavra `a`, mas não por a `í`, `a` ndar ou `outr` a `s`

Dois tipos extra de posições podem ser correspondências na forma acima, nomeadamente a posição no limite de uma palavra e a posição no limite de uma não-palavra. As posições são indicadas usando o texto `\b` (para os limites das palavras), e o `\B` (para os limites de sequências que não são palavras)

Assim, se procurar pela palavra `a`, pode fazê-lo com a expressão regular `\ba\b`. Isto indica que você está à procura da palavra `a` sem letras nenhumas de cada lado dela (i.e., com o limite de uma palavra de cada lado).

As quatro de expressões regulares de correspondências de posições são introduzidas no editor de expressões regulares usando a ferramenta de quatro posições diferentes

### Procurar tanto por `isto` como por `aquilo`

Imagine que quer percorrer o seu documento à procura tanto da palavra `isto` como da palavra `aquilo`. Com um método de procura normal, você conseguiria fazer em duas tentativas, sendo que na primeira iria procurar por `isto` e na segunda iria procurar por `aquilo`.

Ao usar as pesquisas usando as expressões regulares, você iria procurar por ambas as sequências de uma vez. Você faria isso ao procurar por `isto|aquilo`, isto é, separando as sequências por uma barra vertical.

Repare que em cada lado da barra vertical existe uma expressão regular, como tal esta funcionalidade não se aplica apenas para procurar dois pedaços de texto diferentes, mas sim para procurar duas expressões regulares diferentes.

No editor de expressões regulares você não escreve por si próprio a barra vertical, mas sim selecciona a ferramenta de alternativas, introduzindo as sub-expressões regulares uma por cima da outra.

### Corresponder a tudo

As expressões regulares são frequentemente comparadas com os caracteres especiais existentes também na linha de comandos - esta é a capacidade de indicar um conjunto de ficheiros com o asterisco. Você irá provavelmente reconhecer a correspondência com os caracteres especiais a partir dos exemplos seguintes:

- `ls *.txt` - aqui o `*.txt` corresponderá a todos os ficheiros que terminem na extensão `.txt`.

- `cat teste??.res` - corresponde a todos os ficheiros que comecem por `teste`, seguido de dois caracteres quaisquer, terminando finalmente em `.res`

Na linha de comandos o asterisco corresponde a qualquer carácter, segundo uma quantidade qualquer. Por outras palavras, o asterisco corresponde a tudo. Isto é escrito com o formato `.*` na sintaxe das expressões regulares. O ponto corresponde a um carácter qualquer, individualmente, isto é, a apenas um carácter, enquanto que o asterisco indica que a expressão anterior a ele deverá ter uma correspondência repetida por várias vezes. Em conjunto, isto diz que corresponde a qualquer conjunto de caracteres arbitrários com tamanho também arbitrário.

Isto poderá parecer mais ou menos complicado, mas quando tiver uma ideia global, irá ver o seu poder. Deixe que lhe seja mostrada outra expressão regular básica: o `e`. A letra `e` por si só é uma expressão regular que corresponde a uma única letra, nomeadamente a letra `e`. Se combinar isto com o asterisco, i.e., `e*`, então obter-se-á uma expressão regular que irá corresponder a uma quantidade arbitrária de e's.

Podem-se combinar várias expressões regulares, umas a seguir às outras, como por exemplo `ba(na)*`.

O `(na)*` apenas diz que o que se encontra dentro de parêntesis é repetido um dado número qualquer de vezes.

Imagine que você escreveu esta expressão regular no campo de procura de um editor de texto; nesse caso iria obter as seguintes palavras (entre outras): `ba`, `bana`, `banana`, `bananananananana`

Dada a informação acima, espera-se que não seja difícil para si escrever a sequência da linha de comandos `teste??.res` como uma expressão regular. A resposta é: `teste..\.res`. O ponto por si só significa qualquer carácter. Para corresponder a um único ponto você precisa de escrever `\.`

Isto corresponder a 'escapar'.

. Por outras palavras, a expressão regular `\.` corresponde a um ponto, enquanto que um ponto sozinho corresponde a qualquer carácter.

No editor de expressões regulares, a expressão regular repetida é criada através da ferramenta de repetição

### Substituir o `&` por `&amp;` num documento de HTML

No HTML, o carácter especial `&` deverá ser escrito como `&amp;` - isto assemelha-se a 'escapar' nas expressões regulares.

Imagine que escreveu um documento em HTML num editor normal (p.ex., o XEmacs ou o Kate), e se esqueceu por completo desta regra. O que você teria de fazer ao descobrir o seu erro seria substituir todas as ocorrências de `&` por `&amp;`.

Isto pode ser feito facilmente usando a procura e substituição normais, só que existe, contudo, um pormenor. Imagine que se lembrou de facto desta regra - só um bocadinho - e que resultava em alguns pontos. A substituição incondicional iria resultar em que o `&amp;` seria substituído por `&amp;amp;`

O que você queria mesmo dizer era que o `&` só deveria ser colocado se não fosse seguido pelas letras `amp;`. Você pode fazer isto usando expressões regulares com leitura antecipada positiva.

A expressão regular que só faria corresponder o 'e comercial' se não for seguido das letras `amp;` assemelha-se ao seguinte: `&(?!amp;)`. Isto é, obviamente, mais simples de ler usando o editor de expressões regulares, onde você iria utilizar as ferramentas de leitura antecipada.

## Usar o Editor de Expressões Regulares

Este capítulo explicar-lhe-á como o editor de expressões regulares funciona.

### A organização do ecrã

A componente mais importante do editor é, como será de esperar, a área de edição; esta é a área onde você desenha a sua expressão regular. A área em questão é a zona acinzentada no meio.

Por cima da área de edição existem duas barras de ferramentas, onde a primeira contém as acções de edição - muito parecidas com as ferramentas de desenho num programa de desenho. A segunda barra de ferramentas contém o botão de o que é isto, assim como os botões para desfazer e refazer.

Sob a área de edição é possível encontrar a expressão regular construída neste momento, descrita na sintaxe denominada por ASCII. A sintaxe de ASCII é actualizada enquanto você edita a expressão regular no editor gráfico. Se você quiser, por outro lado, actualizar a sintaxe de ASCII está à vontade para o fazer; nesse caso, o editor gráfico actualiza-se na altura para reflectir as suas alterações.

Finalmente, à esquerda da área de edição, você encontra um conjunto de expressões regulares pré-concebidas. Estas servem para dois fins: (1) Quando você carregar o editor com uma expressão regular, então esta é tornada mais bonita ou mais compreensível se substituir as expressões regulares comuns. No resultado do ecrã acima, você pode ver como é que a sintaxe ASCII foi substituída por uma caixa que diz "tudo". (2) Quando você introduz expressões regulares, poderá encontrar um conjunto de peças de construção para a sua própria expressão regular a partir do conjunto de expressões regulares predefinidas. Veja a secção sobre as expressões regulares definidas pelo utilizador para aprender como gravar as suas próprias expressões regulares.

### Ferramentas de Edição

O texto nesta secção espera que você tenha lido o capítulo sobre o que é uma expressão regular ou que tenha algum conhecimento prévio sobre o assunto.

Todas as ferramentas de edição estão localizadas na barra de ferramentas por cima da área de edição. Cada uma delas será descrita a seguir.

#### Ferramenta de Selecção

A ferramenta de selecção é usada para marcar os elementos para as operações de cortar-e-colar e de arrastar-e-largar. Isto é muito semelhante à ferramenta de selecção num programa de desenho.

#### Ferramenta de Texto

Se usar esta ferramenta você irá introduzir algum texto normal com o qual irá fazer a correspondência. O texto é correspondido literalmente, i.e., você não terá que escapar os caracteres especiais. No exemplo acima, a seguinte expressão regular será criada: `abc\*\\\)`

#### Ferramenta de Caracteres

Se usar esta ferramenta, você irá introduzir gamas de caracteres. Os exemplos incluem que o texto ASCII diz `[0-9]` e `[^a-zA-Z,_]`. Ao introduzir um item com esta ferramenta, aparecerá uma janela na qual você poderá indicar as gamas ou intervalos de caracteres.

Veja a descrição das expressões regulares repetidas.

#### Ferramenta para Qualquer Carácter

Esta é a expressão regular do "ponto" (.). Esta aceita qualquer caracter isolado.

#### Ferramenta de Repetição

Isto corresponde aos elementos repetidos. Isto inclui o que, na sintaxe ASCII, é representado usando um asterisco (*), um sinal de mais (+), um ponto de interrogação (?) e os intervalos ({3,5}). Quando introduzir um item com esta ferramenta, aparecerá uma janela que irá perguntar quantas vezes terá a repetição.

Você indica o que deseja repetir ao desenhar o conteúdo repetido dentro da caixa que esta ferramenta introduz.

Os elementos repetidos podem tanto ser construídos de dentro para fora como vice-versa. Isto significa que você pode desenhar primeiro o que será repetido, seleccioná-lo e usar a ferramenta de repetição para o replicar ou, em alternativa, pode indicar primeiro o número de repetições e desenhar o que se pretende repetir dentro dele.

Veja a descrição sobre as expressões regulares repetidas.

#### Ferramenta de Alternativas

Esta é a expressão regular para as alternativas (|). Você indica as alternativas quando desenha cada uma delas por cima da anteriores dentro da caixa que esta ferramenta introduz.

Veja a descrição sobre as expressões regulares para as alternativas

#### Ferramenta de Composição

A ferramenta de composição não representa nenhumas expressões regulares. É usada para agrupar outras sub-componentes em conjunto dentro de uma caixa, a qual poderá facilmente ser fechada, restringindo-se apenas ao seu título. Isto poderá ser visto na parte direita do resultado do ecrã acima.

#### Ferramentas do Início/Fim da Linha

As ferramentas do início e do fim de linha correspondem, respectivamente ao início da linha ou ao seu fim, como seria de esperar. A expressão regular no resultado do ecrã acima corresponde deste modo às linhas que só tenham espaços.

Veja a descrição sobre as expressões regulares de posição.

#### Ferramentas de (Não-)Limite das Palavras

As ferramentas dos limites fazem a sua correspondência com os limites das palavras ou das outras sequências que não representem palavras, respectivamente. A expressão regular no resultado do ecrã acima corresponderá às palavras que comecem por `the`. A palavra `the` em si, todavia, não fará correspondência.

Veja a descrição sobre as expressões regulares dos limites.

#### Ferramentas de Leitura Antecipada Positiva/Negativa

As ferramentas de leitura antecipada tanto poderão corresponder a expressões positivas ou negativas. A correspondência não faz, contudo, parte da correspondência total.

Nota: Só lhe é permitido colocar leituras antecipadas no fim das expressões regulares. O Editor de Expressões Regulares não obriga a isto.

Veja a descrição sobre as expressões regulares com leitura antecipada.

### Expressões Regulares Definidas pelo Utilizador

À esquerda a área de edição existe uma lista que contém as expressões regulares definidas pelo utilizador. Algumas das expressões regulares vêm incluídas na sua instalação do KDE, enquanto que outras poderão ser gravadas por si.

Estas expressões regulares servem dois propósitos (ver uma descrição detalhada), nomeadamente (1) oferecer ao utilizador um conjunto de peças de construção e (2) tornar as expressões regulares comuns mais bonitas.

Você poderá gravar as suas próprias expressões regulares ao carregar com o botão direito do rato na área de edição e ao escolher a opção `Gravar a Expressão Regular`.

Se a expressão regular que gravar estiver dentro de um bloco de composição, então a expressão regular irá ajudar a tornar as expressões regulares subsequentes mais bonitas.

A expressão regular definida pelo utilizador pode ser removida ou ver o seu nome alterado ao carregar com o botão direito na lista, mais precisamente no cimo da expressão regular em questão.

## Comunicar erros e sugerir funcionalidades

Os erros e funcionalidades comunicados são introduzidos no Sistema de Registo de Erros do KDE. Antes de comunicar um erro ou sugerir uma funcionalidade, verifique primeiro se esta não foi já comunicada/sugerida.

## Perguntas Mais Frequentes

### O editor de expressões regulares suporta referências anteriores?

Não, de momento isto não é suportado. Está planeado para a próxima versão.

### O editor de expressões regulares suporta a apresentação das ocorrências?

Não, mas espera-se que isto esteja disponível na próxima versão.

### Eu sou o autor de um programa do KDE, como é que posso usar este item na minha aplicação?

Veja na documentação da classe KRegExpEditorInterface.

### Não consigo encontrar o botão Editar a Expressão Regular numa instalação do KDE 3 ou no 'konqueror', por exemplo. Porquê?

O item de expressões regulares está localizado no pacote 'KDE-utils'. Se você não tiver este pacote instalado, então os botões para editar expressões regulares não irão aparecer nos programas.

## Créditos e Licenças

Documentação copyright 2001, Jesper K. Pedersen blackie@kde.org

&underGPL; &underFDL;