# 7.5. Procurar e Substituir

## 7.5.1. Procura num Único Ficheiro

Como encontrar um ou mais caracteres na janela de edição actual

1. Seleccione "Procurar" a partir do menu "Editar". Isto abre um diálogo de procura.

2. Especifique a expressão a procurar no campo de edição. O menu de caixa permite a escolha de uma expressão de busca anterior.

3. Seleccione opções adicionais tais como "Apenas Palavras Inteiras"

4. Prima OK.

Para repetir a busca por uma expressão inserida no diálogo de procura, prima F3.

## 7.5.2. Procurar em Vários Ficheiros

Como a função de procura está a realizar buscas sobre apenas um ficheiro que está actualmente visível, encontra-se limitado a isto. Mas muitas vezes você deseja procurar a mesma expressão em todo o seu projecto. Assim, o KDevelop contém um diálogo `grep`, que lhe permite procurar sobre todos os ficheiros que especificar quer através da definição do directório onde iniciar a busca e/ou por tipos mime. Especificando o directório exacto e o tipo mime irá assim reduzir o tempo que o KDevelop necessita para ler os ficheiros e apresentar os resultados. Para iniciar uma busca sobre vários ficheiros, seleccione "Procurar nos ficheiros..." a partir do menu "Editar". O diálogo deprocura abre e permite-lhe inserir:

- A expressão a procurar (o padrão)

- O modelo utilizado para a busca

- O tipo mime dos ficheiros onde procurar

- O directório onde começar

- Se a busca é recursiva sobre todos os subdirectórios incluidos

Por defeito, o diálogo grep está definido para iniciar no directório do seu projecto e trabalhar recursivamente sobre os ficheiros de implementação e header.

Pode até ampliar o seu padrão de busca utilizando as seguintes opções:

1. . Equivale a qualquer caractere

2. &ˆ; Equivale ao princípio de uma linha

3. $ Equivale ao fim de uma linha

4. \< Equivale ao princípio de uma palavra

5. \> Equivale ao fim de uma palavra

Para uma busca repetida, pode também utilizar os operadores disponíbilizados:

1. ? O item precedente é encontrado menos de uma vez

2. * O item precedente é encontrado zero ou mais vezes

3. + O item precedente é encontrado uma ou mais vezes

4. &{; n &}; O item precedente é encontrado exactamente n vezes

5. &{; n,&}; O item precedente é encontrado n ou mais vezes

6. &{;,n &}; O item precedente é encontrado menos de n vezes

7. &{;n,m&}; O item precedente é encontrado pelo menos n vezes mas menos de m vezes

Referências anteriores a subexpressões dentro de aspas estão também disponíveis através da notação \n.

Após especificar a sua busca, prima "Procurar". Os resultados são então apresentados na janela de resultado. Para ir para um ficheiro e número de linha, seleccione a linha do resultado e prima Enter ou clique duplo sobre o resultado. O editor irá automaticamente abrir o ficheiro correspondente e colocar o cursor na linha do resultado. Isto permite uma especificação completa para qualquer acção de procura e devolve resultados exactos.

O KDevelop oferece também algumas funcionalidades mais específicas para a utilização do grep dentro do editor e do navegador. Seleccione a expressão que deseja procurar em qualquer uma das janelas e prima SHIFT+F2 ou seleccione "grep:&<;sua&_;expressão&>;" a partir do menu de contexto acessível pelo botão direito do rato. Isto irá pedir ao grep para procurar pela selecção nos ficheiros no directório do seu projecto e mostrará os resultados imediatamente. Ir para o resultado funciona como descrito acima. A partir da janela de navegação, basta colocar o cursor sobre uma palavra e iniciar a procura; a palavra por baixo do cursor será o padrão de procura.

## 7.5.3. Procurar dentro da Documentação

Enquanto a trabalhar num projecto, muitas vezes você necessita de ter informação sobre parâmetros de funções membras que deseja utilizar- quase sempre você lembra-se do nome da função que responde às suas necessidades, mas os parâmetros são algo muito difícil de memorizar. Assim, e para outros propósitos que possam ocorrer, o KDevelop contém uma funcionalidade de procura que combina a busca de expressões que surgem dentro dos seus ficheiros com o navegador de documentação. Para fazer uso desta funcionalidade de busca, você deverá ter definido o navegador de documentação correctamente e criado a base de dados de pesquisa. Para invocar uma procura através da documentação, faça o seguinte:

1. coloque o cursor na palavra que deseja procurar ou seleccione uma expressão

2. seleccione "Procurar Texto Marcado" a partir do menu "Ajuda" ou prima o botão direito do rato para abrir o menu de contexto; depois seleccione "Procurar : "expressão".

3. após a página de resultados da busca ser apresentada no navegador de documentação, seleccione a página que pensa conter a informação de que necessita.

4. a página de documentação seleccionada é apresentada e o resultado da sua procura é marcado. Para observar o resultado seguinte dentro da mesma página de documentação, prima F3.

Isto permite-lhe procurar facilmente a informação de que necessita. Para utilizar os resultados, o navegador de documentação permite marcar uma selecção e copia-la para a área de transferência. Depois volte para o ficheiro que estava a editar e seleccione "Colar" a partir do menu "Editar".

Para uma descrição completa de como utilizar a Documentação, veja Utilizar o Índice de Busca.

## 7.5.4. Substituir Texto

Para substituir uma expressão, seleccione "Procurar e Substituir" a partir do menu "Editar". O diálogo de "Procurar e Substituir" permite-lhe especificar a expressão a ser substituida bem como a expressão de substituição. Depois prima OK. A primeira expressão que for encontrada será marcada, pelo que pode ver onde a expressão está e em que contexto. Depois pode especificar através de um diálogo se a expressão será substituida ou não. Quando a busca estiver terminada por atingir o final do ficheiro actual, ser-lhe-á perguntado se deseja re-iniciar a procura de novo a partir do início do ficheiro. Se tiver terminado, seleccione "Cancelar".