# Ferramentas Avançadas de Edição

## Comentar/Descomentar

Os comandos Comentar e Descomentar, disponíveis no menu Ferramentas permitem-te adicionar ou remover marcações de comentários à selecção ou à linha actual se não estiver texto seleccionado. Os comentários são suportados pelo formato do texto que estás a editar.

As regras de como os comentários são feitos estão descritas nas definições da sintaxe, por isso se o realce de sintaxe não é usado, o comentar/descomentar não é possível.

Alguns formatos definem comentários para linhas únicas, outros suportam comentários para várias linhas e ainda outros suportam ambos. Se não estiverem disponíveis os comentários para várias linhas, o acto de comentar uma selecção que não inclui por completo a sua última linha não é possível.

Se estiver disponível uma marcação para linhas únicas, o acto de comentar linhas únicas é preferível quando aplicável, dado que evita os problemas com os comentários aninhados.

Ao removeres marcações de comentários, não deve ser escolhido texto sem comentários. Ao retirar as marcações de comentários de várias linhas de uma selecção, todos os espaços em branco fora das marcações de comentários são ignorados.

Para colocares marcações de comentários, utiliza a opção do menu Ferramentas Comentar ou a sequência de teclado relacionada, que por omissão é &Ctrl;#.

Para removeres marcações de comentários utiliza a opção do menu Ferramentas Descomentar ou o atalho de teclado relacionado, que por omissão é o &Ctrl;&Shift;#.

## Comando de Edição

Esta ferramenta, disponível na opção do menu Ferramentas Comando de Edição, permite o acesso a um pequeno conjunto de comandos do estilo do vi/vim para editar o texto. É um ferramenta útil para utilizadores avançados ou experientes, mas não deixes de experimentar as suas potencialidades!

De momento, estão disponíveis os seguintes comandos:

`time`

- Este comando irá devolver a hora actual tal como o teu computador indica no formato HH:MM:SS

  Para o usares, lança a Janela do Comando de Edição e indica no campo de texto a palavra `time`

`char`

- Este comando permite-te introduzir caracteres literais pelo seu identificador numérico em decimal, octal ou hexadecimal. Para o usares lança a Janela do Comando de Edição e escreve `char: [number]` no campo de texto, carregando depois em OK.

  ### Exemplos do `char`

  Introdução: `char:234`

  Resultado: `ê`

  Introdução: `char:0x1234`

  Resultado: `ê`

  Introdução: `char:1232`

  Resultado: `ê`

`s///[ig]` `%s///[ig]`

- Este comando efectua uma operação de pesquisa e substituição à 'sed' na linha actual ou em todo o ficheiro (`%s///`).

  Em resumo, o texto é percorrido à procura de uma sequência que corresponda ao padrão de busca, a expressão regular entre a primeira e a segunda barra, e quando for encontrada uma correspondência, esta é substituída pela expressão entre a parte do meio e a parte final do texto. Os parêntesis no padrão de busca criam referências anteriores, ou seja, o comando recorda qual a parte que correspondeu aos parêntesis; estas sequências podem ser reutilizadas no padrão de substituição, sendo referenciadas como `\1` para o primeiro conjunto de parêntesis, `\2` para o segundo e assim por diante.

  Para procurar por um `(` ou `)`, necessitas de escapá-lo usando uma barra invertida: `\(\)`

  Se indicares um `i` no fim da expressão, a correspondência não fará distinção entre maiúsculas e minúsculas.

  ### Substituir texto na linha actual

  O teu 'amigo' compilador parou, indicando que a classe `myClass` representada na linha 3902 do ficheiro de código não está definida.

  "Bolas!" pensas tu, é óbvio que é `MyClass`. Vais à linha 3902, e em vez de tentares procurar a palavra no texto, lanças a Janela de Comando de Edição, escreves `s/myclass/MyClass/i`, carregas no botão OK, gravas o ficheiro e compilas – com sucesso, sem o erro.

  ### Substituir texto no ficheiro inteiro

  Imagina que tens um ficheiro, no qual mencionas uma Srª Silva várias vezes, quando vem alguém e te diz que ela se casou com o Sr. Pires. Queres, obviamente, substituir todas as ocorrências de Srª Silva por Srª Pires.

  Lança a Janela de Comando de Edição, e escreve no campo de texto: `%s/Srª Silva/Srª Pires/`, carregando em RETURN para terminar.

  ### Um Exemplo Mais Avançado

  Este exemplo tira partido das referências anteriores assim como das classes de palavras (se não souberes o que isso é, baseia-te na documentação referida em baixo).

  Imagina que tens a seguinte linha:

      void MyClass::DoStringOps( String      &foo, String &bar String *p, int  &a, int &b )

  Agora concluis que este não é um código bonito, e decides que queres usar a palavra `const` para todos os endereços dos argumentos, os quais se caracterizam pelo operador & à frente do nome do argumento. Queres também simplificar os espaços em branco, de modo a que haja apenas um espaço entre cada palavra.

  Lança a Janela de Comando de Edição e escreve: `s/\s+(\w+)\s+(&)/ const \1 \2/g` e carrega no botão OK. O `g` no fim da expressão recompila a expressão para cada correspondência para poupar as referências anteriores.

  Resultado: `void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )`

  Missão cumprida! Agora, o que se passou? Bem, procurámos por alguns espaços em branco (`\s+`) seguidos de um ou mais caracteres alfabéticos (`\w+`) seguidos por mais alguns espaços em branco (`\s+`) e um 'e' comercial, gravando durante o processo a sequência alfabética e o 'e' comercial para os reutilizar na operação de substituição. Assim, substituímos a parte correspondente da nossa linha por um espaço em branco seguido de const, um espaço em branco e depois pela sequência alfabética (`\1`) seguida de um espaço em branco e o '&' guardado (`\2`)

  Agora, em alguns dos casos, a sequência alfabética era String, em outras era int, de modo que a utilização da classe de caracteres `\w` e do quantificador `+` foram uma ajuda preciosa.

Isto é extremamente poderoso, e ainda que as acções possam ser anuladas com o comando Desfazer várias vezes (como é necessário) recomendo que pratiques um pouco antes de começares a usar este comando para edições mais séries se não estiveres familiarizado com o sed ou com as expressões regulares do Perl.