Busca e atalhos

Seu objetivo: escolher a busca certa para encontrar um arquivo, um trecho ou uma ação.

Pense antes de seguir: Para encontrar um nome de arquivo, qual busca você escolheria?

A Kinein Vectis tem três buscas: por arquivo, por texto no projeto inteiro e por texto no arquivo aberto. As duas primeiras usam programas do sistema, que você instala primeiro.

As capturas usam o programa de mensagem do primeiro projeto C++. Você pode manter seu cálculo de temperaturas: nomes, linhas e quantidade de resultados dependem do conteúdo atual do projeto.

Instale o fd e o ripgrep

O fd encontra arquivos pelo nome, e o ripgrep procura texto dentro deles:

sudo apt install fd-find ripgrep

No Ubuntu, o comando do fd se chama fdfind, e a IDE procura pelos dois nomes. Confira:

fdfind --version
rg --version | head -n 1

Sem o fd, a busca de arquivos não acha nada e avisa fd nao foi encontrado no PATH.

Abra um arquivo pelo nome

Com o ola-kinein aberto, aperte Ctrl+Shift+N. É o Search Everywhere. Digite parte do nome do arquivo, como main:

A janela Search Everywhere com main digitado e um resultado: main.cpp, em src/main.cpp

Cada resultado mostra o nome e, embaixo, a pasta.

As setas escolhem um resultado, Enter abre e Esc fecha.

Num projeto Python, na 0.3.5, a busca também lista os arquivos do .venv, e o resultado do seu projeto pode ficar no meio deles. Digite o nome mais completo para filtrar.

Procure um texto no projeto

Ctrl+Shift+F abre a aba Busca do painel de baixo. Digite Kinein e aperte Enter:

A aba Busca com Kinein digitado e 8 resultados, cada um com arquivo e linha: cinco no CMakeLists.txt, dois no README.md e um no src/main.cpp

Cada resultado é arquivo:linha seguido do trecho encontrado.

Clicar num resultado abre o arquivo com o cursor naquela linha. Por padrão, a busca não diferencia maiúsculas: Kinein também achou ola-kinein. O botão Aa, ao lado do campo, liga a diferença.

Procure no arquivo aberto

Com o main.cpp no editor, Ctrl+F abre uma barra no canto do editor. Digite cout:

O editor com o main.cpp e a barra de busca no canto: cout digitado, os botões Aa, W e .* e as setas; a ocorrência de cout destacada na linha 5

A barra conta as ocorrências e destaca cada uma no código.

Enter vai para a próxima ocorrência e Esc fecha a barra. Os botões ligam a diferença de maiúsculas (Aa), a palavra inteira (W) e as expressões regulares (.*).

Ache um comando e o atalho dele

O Search Everywhere também acha os comandos da IDE, cada um com o atalho ao lado. Digite build:

O Search Everywhere com build digitado: Build Project com Ctrl+F9, Run Tests com Ctrl+Shift+F9, Analyze (Lint) com Ctrl+Shift+L, Cobertura dos testes e CMake: Configure

Enter roda o comando escolhido.

Na 0.3.5, parte dos comandos tem nome em inglês. Os de compilar, testar e executar se chamam Build Project, Run Tests e Run: procure por build ou run, porque compilar e executar não acham nada. Os do Git estão em português, como Git: Commit....

É um bom jeito de descobrir atalhos: procure o comando e veja a tecla ao lado.

Os atalhos do Guia

Estes são os atalhos usados nos capítulos até aqui:

Atalho	O que faz
`Ctrl`+`O`	Abrir uma pasta ou criar um projeto
`Ctrl`+`S`	Salvar o arquivo
`Ctrl`+`Alt`+`B`	Compilar
`Ctrl`+`Shift`+`F9`	Rodar os testes
`Alt`+`F12`	Abrir o terminal
`Alt`+`7`	Abrir ou fechar os Símbolos
`Ctrl`+`Shift`+`N`	Search Everywhere: arquivos e comandos
`Ctrl`+`Shift`+`F`	Procurar texto no projeto
`Ctrl`+`F`	Procurar no arquivo aberto

A tabela completa está no fim do manual da IDE, em Ajuda → Manual da IDE.

Confira o que aprendeu

Sem reler as etapas, responda:

Para encontrar um nome de arquivo, qual busca você escolheria?
E para procurar texto em vários arquivos?
Como procurar somente dentro do arquivo aberto?

Conferir seu raciocínio

Ctrl+Shift+N encontra arquivos e comandos; Ctrl+Shift+F procura texto no projeto; Ctrl+F procura no arquivo aberto. Na 0.3.5, procure build ou run para os comandos de compilação e execução.