# Strumenti avanzati di modifica

## Commenta/Decommenta

I comandi Commenta e Decommenta, disponibili nel menu Strumenti ti permettono di aggiungere o rimuovere marcatori di commento alla selezione, o alla corrente riga di testo se non hai selezionato niente. In base alla sintassi del tipo di file che stai scrivendo o modificando il programma commenterà o meno il testo nella maniera adeguata.

Le regole su come è applicato il commento sono definite in base alla sintassi del testo che stai scrivendo, quindi se non hai selezionato una modalità di evidenziazione, non potrai usare Commenta/Decommenta.

Alcuni formati usano marcatori di commento su ciascuna riga commentata (marcatori monolinea), altri usano marcatori all'inizio e alla fine di un blocco di testo commentato (marcatori multilinea) ed altri ancora entrambi i sistemi. Se i marcatori multilinea non sono disponibili, commentare una selezione che non comprenda completamente la sua ultima riga non è possibile.

Se sono disponibili i marcatori monolinea sarebbe meglio utilizzarli sempre dove è possibile, questo aiuterebbe a evitare molti problemi con i commenti nidificati.

Quando rimuovi i commenti devi fare attenzione a selezionare solo del testo commentato. Quando rimuovi i commenti multilinea da una selezione, ogni spazio vuoto fuori dai marcatori di commento verrà ignorato.

Per inserire i marcatori di commento, usa il comando Strumenti Commenta oppure la relativa scorciatoria da tastiera, la scorciatoia di default è &Ctrl;# .

Per rimuovere i marcatori di commento, usa il comando Strumenti Decommenta oppure la relativa scorciatoia da tastiera, la scorciatoia di default è &Ctrl;&Shift; #.

## Comando di modifica

Questo strumento, disponibile dal menu Strumenti Comando di modifica, fornisce l'accesso a una piccola serie di comandi di modifica testo simili al vi o al vim. È uno strumento molto utilizzato dagli utenti esperti, ma non ti spaventare! Prova le sue incredibili potenzialità!

Attualmente, sono disponibili i seguenti comandi:

`time`

- Questo comando inserirà l'orario corrente in formato HH:MM:SS

  Per usarlo, apri la finestra di dialogo Comando di modifica e inserisci nel campo di testo la parola `time`

`char`

- Questo comando ti permette di inserire caratteri indicando il loro identificativo numerico, in decimale, ottale o esadecimale. Per usarlo apri la finestra di dialogo Comando di modifica e digita `char: [numero]` nel campo di inserimento, quindi clicca su OK.

  ### Esempi con il comando `char`

  Inserisci: `char:234`

  Ottieni: `ê`

  Inserisci: `char:0x1234`

  Ottieni: `ê`

  Inserisci: `char:1232`

  Ottieni: `ê`

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

- Questo comando fa una ricerca/sostituzione nella riga di testo corrente o in tutto il file ( `%s///`) in maniera del tutto simile a sed.

  In breve, la ricerca viene effettuata in base a un pattern di ricerca, a una espressione regolare compresa tra la prima e la seconda barra rovescia. Quando viene trovata una corrispondenza la parte che corrisponde viene sostituita con la espressione compresa tra la metà e l'ultima parte della stringa. Le parentesi nel pattern di ricerca creano dei riferimenti all'indietro, vale a dire che il comando ricorda quali parti della stringa di ricerca tra parentesi hanno trovato corrispondenza; queste stringhe possono essere riutilizzate per sostituire pattern riferiti a `\1` per il primo gruppo di parentesi, `\2` per il secondo e così via.

  Per cercare precisamente il simbolo di parentesi `(` o `)`, devi evitare il problema usando la barra rovescia in questo modo: `\(\)`

  Se metti una `i` alla fine dell'espressione, la ricerca non terrà conto della distinzione tra maiuscole e minuscole.

  ### Sostituire del testo nella riga corrente

  Il tuo caro vecchio compilatore ha appena finito di bloccarsi dicendoti che la classe `myClass` che compare nella riga 3902 del tuo file sorgente non è definita.

  "Naturale!" pensi, sai benissimo che si scrive `MyClass`. Vai alla riga 3902 e, invece di provare a cercare la parola nel testo, apri la finestra di dialogo Comando di modifica, inserisci `s/myclass/MyClass/i`, premi OK, salvi il file e lo compili – consuccesso senza errori.

  ### Sostituire del testo nell'intero file

  Immagina di avere un file, nel quale nomini Miss Jensen parecchie volte e arriva qualcuno che ti dice che si è appena sposata con Mr Jones. Naturalmente tu vuoi sostituire tutti i Miss Jensen con Ms Jones.

  Lancia la finestra di dialogo Comando di modifica, digita nell'apposito campo `%s/Miss Jensen/Ms JOnes/` e premi invio... il gioco è fatto!

  ### Esempi più avanzati

  Questo esempio usa i riferimenti all'indietro così come la word class (se non sai cosa cos'è, per favore leggiti la relativa documentazione citata più in basso).

  Immagina di avere la seguente riga:

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

  Ora ti rendi conto che non è proprio carino il codice scritto così e decidi di usare la parola chiave `const` per tutti gli argomenti address of, che sono caratterizzati dall'operatore & posto davanti al nome dell'argomento. A te inoltre piacerebbe semplificare lo spazio vuoto in modo tale che ci sia solo 1 spazio tra ogni parola.

  Apri la finestra di dialogo Comando di modifica e inserisci: `s/\s+(\w+)\s+(&)/ const \1 \2/g` e premi il bottone OK. La `g` che si trova alla fine dell'espressione fa in modo che si ricompili un'espressione regolare, per ogni corrispondenza, da essere poi salvata comeriferimento all'indietro.

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

  Missione compiuta! Ora cos'è successo? Abbiamo cercato alcuni spazi vuoti (`\s+`) seguiti da alcuni caratteri alfabetici (`\w+`), seguiti da altri spazi vuoti (`\s+`), seguiti da una e commerciale e la porzione alfabetica con la e commerciale salvati nel processo per essere usati nell'operazione di sostituzione. Quindi abbiamo sostituito la parte corrispondente della nostra riga con uno spazio vuoto seguito da const, seguito da un'altro spazio vuoto, seguito dalla porzione alfabetica (`\1`), seguito da uno spazio vuoto e infine seguito dalla e commerciale salvata (`\2`)

  Ora, in alcuni casi la porzione alfabetica era una String. in altri int, quindi se usi `\w` e il quantificatore `+` sarà meglio.

Questo è estremamente potente e sebbene le azioni possano essere annullate richiamando il comando Annulla parecchie volte (quelle che ti servono), ti consiglio di fare un po' di pratica prima di usare questo comando per fare dell'editing serio, soprattutto se non hai familiarità con le espressioni regolari di sed o del perl.