Eines d'edició avançades

Comenta/descomenta
Les ordres Comenta i Descomenta, disponibles des del menú Eines us permeten afegir o eliminar marques de comentari per a la selecció, o de la línia actual si no hi ha cap selecció. El format dels comentaris dependrà del format del text que esteu editant.
Les regles que determinen com hauran de ser els comentaris s'estableixen en les definicions de sintaxi, de manera que si no s'utilitza el ressaltat de la sintaxi, no serà possible fer això.
Alguns formats defineixen marques de comentaris d'una sola línia, d'altres de múltiples línies i d'altres utilitzen ambdues possibilitats. Si no hi ha disponibles les marques de comentaris de múltiples línies, no serà possible comentar una selecció en què l'última línia d'aquesta no estigui inclosa completament.
Si hi ha disponible una marca de comentari d'una sola línia, és preferible comentar les línies individualment, atès que així s'eviten problemes de comentaris imbricats.
En eliminar les marques de comentari, s'haurà de seleccionar el text sense comentar. En eliminar les marques de comentari multilínia d'una selecció, s'ignorarà qualsevol espai en blanc que quedi fora de les marques de comentari.
Per a posar marques de comentari, utilitzeu l'element Eines Comenta del menú o la drecera de teclat corresponent, de manera predeterminada és D.
Per a eliminar marques de comentari, utilitzeu l'element Eines Descomenta del menú o la drecera de teclat corresponent, de manera predeterminada és D.

El component de la línia d'ordres de l'editor
El component editor de la té una línia d'ordres interna, permetent-vos dur a terme diverses accions des d'una mínima. La línia d'ordres és una entrada de text a la part inferior de l'àrea d'edició, i per a veure-la només haureu de seleccionar Visualitza Canvia a línia d'ordres o utilitzar la drecera (de manera predeterminada és F7). L'editor proveeix un joc d'ordres com les que es documenten a continuació, així com aquelles altres que es puguin proveir a partir dels connectors.
Per a executar una ordre, escriviu-la i després premeu la tecla . La línia d'ordres indicarà què ha succeït mostrant un possible missatge. Si entreu a la línia d'ordres i premeu F7 aquest missatge s'ocultarà automàticament després d'uns pocs segons. Per a esborrar el missatge i introduir una ordre nova, premeu F7 altra vegada.
La línia d'ordres té un sistema d'ajuda inclòs, escriviu l'ordre help per a iniciar-la. Per a veure una llista de totes les ordres disponibles escriviu help list. Per a veure l'ajuda específica d'una ordre, escriviu help ordre.
La línia d'ordres té integrat un historial, de manera que podreu tornar a utilitzar les ordres ja teclejades. Per a navegar a través de l'historial, utilitzeu les tecles i . Quan es mostrin les ordres de l'historial, restarà seleccionada la part de l'argument, permetent-vos tornar a escriure-les amb facilitat.

Ordres estàndard de la línia d'ordres

Tipus d'arguments
BOOLEÀ 	Aquest s'utilitza amb ordres que activen o desactiven coses. Els valors acceptats són: on (activat), off (desactivat), true (cert), false (fals), 1 (activat) o 0 (desactivat).
ENTER 	Un nombre enter.
CADENA 	Una cadena, entre cometes simples (') o cometes dobles (") si conté espais.

Ordres per a configurar l'editor
Aquestes ordres són les proporcionades pel component editor, i permeten configurar només la vista i el document actiu. Això és especialment pràctic si voleu utilitzar una configuració diferent de la predeterminada, per exemple per al sagnat.
set-tab-width ENTER amplada
	Estableix l'amplada de la pestanya al número amplada.
set-indent-width ENTER amplada
	Estableix l'amplada del sagnat al número amplada. Només s'utilitza si esteu sagnant amb espais.
set-word-wrap-column ENTER amplada
	Estableix l'amplada per a l'ajust de línia al número amplada. Només s'utilitza si teniu l'ajust de línia automàtic.
set-icon-border BOOLEÀ enable
	Estableix la visibilitat de la vora de les icones.
set-folding-markers BOOLEÀ enable
	Estableix la visibilitat de la subfinestra de les marques de plegat.
set-line-numbers BOOLEÀ enable
	Estableix la visibilitat de la subfinestra dels números de línia.
set-replace-tabs BOOLEÀ enable
	Si està activat, se substitueixen els espais de tabulació per espais normals mentre aneu escrivint.
set-remove-trailing-space BOOLEÀ enable
	Si està activat, els espais en blanc finals seran eliminats en el moment en què el cursor surti d'una línia.
set-show-tabs BOOLEÀ enable
	Si està activat, els caràcters de tabulació i espais en blanc finals es veuran com un punt petit.
set-show-indent BOOLEÀ enable
	Si està activat, el sagnat es veurà com una línia puntejada vertical.
set-indent-spaces BOOLEÀ enable
	Si està activat, l'editor farà un sagnat amb indent-width espais per a cada nivell de sagnat, en comptes d'un caràcter de tabulació.
set-mixed-indent BOOLEÀ enable
	Si està activat, la utilitzarà una barreja de tabulacions i espais per al sagnat. Cada nivell de sagnat serà d'amplada indent-width, i els diferents nivells de sagnat s'optimitzaran utilitzant el màxim de caràcters de tabulació com sigui possible.
Quan s'executa, aquesta ordre activa el sagnat amb espais, i si no s'especifica l'amplada se li assignarà un valor igual que la meitat de tab-width per al document en temps d'execució.
set-word-wrap BOOLEÀ enable
	Activa l'ajust dinàmic de la línia d'acord amb el valor enable.
set-replace-tabs-save BOOLEÀ enable
	Quan està activat, les tabulacions seran substituïdes amb espais en blanc en desar el document.
set-remove-trailing-space-save BOOLEÀ enable
	Quan està activat, els espais finals seran eliminats de cada línia en desar el document.
set-indent-mode CADENA nom
	Estableix el mode de sagnat automàtic a nom. Si nom és desconegut, el mode seleccionat serà «none». Els modes vàlids són «none», «normal», «cstyle», «haskell», «lilypond», «lisp», «python», «ruby» i «xml».
set-auto-ident BOOLEÀ script
	Activa o desactiva el sagnat automàtic.
set-highlight CADENA ressaltat
	Estableix el sistema de ressaltat de la sintaxi per al document. L'argument haurà de ser un nom de ressaltat vàlid, com aquells que es poden veure en el menú Eines Ressaltat. Aquesta ordre proveeix una llista de compleció automàtica per als seus arguments.
reload-scripts
	Torna a carregar tots els scripts en emprats pel , inclosos els scripts de sagnat i de línia d'ordres.
set-mode CADENA mode
	Tria l'esquema del tipus de fitxer per al document actual.
nn[oremap] CADENA original CADENA mapped
	Mapa de la seqüència de tecles original a mapped.

Ordres per a l'edició
Aquestes ordres modifiquen el document actual.
indent
	Sagna les línies seleccionades o la línia actual.
unindent
	Treu el sagnat de les línies seleccionades o la línia actual.
cleanindent
	Treu el sagnat de les línies seleccionades o la línia actual d'acord amb la configuració de sagnat que teniu establerts al document.
comment
	Insereix marques de comentari fent que la selecció, les línies seleccionades o la línia actual siguin un comentari d'acord amb el format de text que s'hagi definit al ressaltat de la sintaxi per al document.
uncomment
	Elimina les marques de comentari de la selecció, de les línies seleccionades o la línia actual, d'acord amb el format del text tal com és definit per la definició de ressaltat de la sintaxi per al document.
kill-line
	Elimina la línia actual.
replace CADENA patró CADENA substitució
	Substitueix el text en què coincideixi el patró amb el valor de substitució. Si voleu incloure espais en blanc en el patró, haureu de posar entre cometes tant el patró com la substitució amb cometes simples o dobles. Si els arguments no es troben entre cometes, s'utilitzarà la primera paraula com a patró i la resta com a substitució. Si la substitució està buida, cada ocurrència del patró serà eliminada.
Podeu establir etiquetes per a configurar la cerca afegint dos punts, seguits d'una o més lletres cadascuna de les quals representa una configuració, quedant de la forma replace:opcions patró substitució. Les opcions disponibles són:
b 	Cerca enrere.
c 	Cerca des de la posició del cursor.
e 	Cerca només en el text seleccionat.
r 	Cerca utilitzant una expressió regular. Si està establerta, podeu utilitzar \N a on N serà un número per a representar captures en la cadena de substitució.
s 	Cerca distingint entre majúscules i minúscules.
p 	Demana permís per a substituir la següent ocurrència.
w 	Només coincidiran paraules senceres.
date CADENA format
	Insereix una cadena de data/hora definida d'acord amb el format, o si aquest no s'especifica s'utilitzarà el format aaaa-MM-dd hh:mm:ss. La interpretació del format serà la següent:
d	El dia com a número sense zeros a l'esquerra (1-31).
dd	El dia com a número amb dos dígits (01-31).
ddd	L'abreujament del nom del dia segons la localització (, «Dl»..«Dg»).
dddd	El nom llarg del dia segons la localització (, «Dilluns»..«Diumenge»).
M	El mes com a número sense zeros a l'esquerra (1-31).
MM	El mes com a número amb dos dígits (01-31).
MMMM	El nom llarg del mes segons la localització (, «Gener»..«Desembre»).
MMM	El nom abreujat del mes segons la localització (, «Gen»..«Dec»).
yy	L'any amb un número de dos dígits (00-99).
yyyy	L'any amb un número de quatre dígits (1752-8000).
h	L'hora sense zeros a l'esquerra (0..23 o 1..12 si es mostra AM/PM).
hh	L'hora amb dos dígits (00..23 o 01..12 si es mostra AM/PM).
m	Els minuts sense zeros a l'esquerra (0..59).
mm	Els minuts amb dos dígits (00..59).
s	Els segons sense zeros a l'esquerra (0..59).
ss	Els segons amb dos dígits (00..59).
z	Els mil·lisegons sense zeros a l'esquerra (0..999).
zzz	Els mil·lisegons amb tres dígits (000..999).
AP	S'usa per a mostrar AM/PM. AP serà substituït per «AM» o «PM».
ap	S'usa per a mostrar am/pm. ap serà substituït per «am» o «pm».
char CADENA identificador
	 Aquesta ordre permet inserir caràcters literals pel seu identificador numèric, en format decimal, octal o hexadecimal. Per a utilitzar-la llanceu el diàleg Ordre d'edició i escriviu char:[número] en el quadre d'entrada, després premeu D'acord.

Exemples de char
Entrada: char:234
Eixida: ê
Entrada: char:0x1234
Eixida: ሴ
s///[ig] %s///[ig] 	 Aquesta ordre realitzarà una operació de cerca/substitució similar a les de «sed» sobre la línia actual o en tot el fitxer (%s///).
Abreujat, se cerca en el text alguna cadena que coincideixi amb el patró de cerca, l'expressió regular entre la primera i la segona barra, i quan es troba una coincidència, la part coincident del text és substituïda per l'expressió continguda entre les barres segona i última. Els parèntesis en el patró de cerca creen referències enrere, és a dir, que l'ordre recorda quina part de la cadena es correspon amb els parèntesis; aquestes cadenes es poden tornar a utilitzar en el patró de substitució, referint-se a elles com a \1 per al primer conjunt de parèntesis, \2 per al segon i així successivament.
Per a fer una cerca literal de ( o ), haureu d'escapar el caràcter emprant un altre caràcter de barra inversa: \(\)
Si poseu una i al final de l'expressió, les coincidències distingiran majúscules i minúscules. Si poseu una g al final, se substituiran totes les ocurrències del patró, en qualsevol altre cas només se substituirà la primera ocurrència.

Substitució de text en la línia actual
El vostre bon amic l'ordinador s'ha aturat, dient que la classe myClass mencionada en la línia 3902 del fitxer font no està definida.
«Llamps i trons!» Pensareu. Per descomptat és MyClass. Anireu fins a la línia 3902 i en comptes d'intentar cercar la paraula en el text, obrireu el diàleg Ordre d'edició, introduireu s/myclass/MyClass/i, premereu el botó D'acord, desareu el fitxer i tornareu a compilar aquesta vegada sense l'error.

Substitució de text en tot el fitxer
Imagineu que teniu un fitxer, en el que mencioneu a Miss Jensen diverses vegades, quan resulta que algú ve i us diu que s'acaba de casar amb Mr Jones. Per descomptat, voldreu substituir cada ocurrència de Miss Jensen per Ms Jones.
Entreu a la línia d'ordres, escriviu l'ordre %s/Miss Jensen/Ms Jones/, una vegada premeu ja estarà fet.

Un exemple més avançat
Aquest exemple fa ús de referències enrere així com d'una classe de caràcter (si no sabeu què és això, si us plau, consulteu la documentació mencionada a sota).
Suposeu que teniu la següent línia:

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

Però us adoneu que aquest codi no està bé i decidiu que voleu utilitzar la paraula clau const per a tots els arguments adreça de, que es caracteritzen per tenir un operador & al davant del nom de l'argument. També voldreu simplificar l'espai en blanc, de manera que només n'hi hagi un entre cada paraula.
Obriu el diàleg Ordre d'edició i introduïu: s/\s+(\w+)\s+(&)/ const \1 \2/g, i després premeu el botó D'acord. La g al final de l'expressió fa que l'expressió regular recompili cada coincidència per a desar les referències enrere.
Eixida: void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )
Missió completada! Ara, què ha passat? Vaja, hem cercat algun espai en blanc (\s+) seguit d'un o més caràcters alfabètics (\w+) seguits d'algun espai en blanc (\s+) seguit del símbol «&», i en el procés hem desat el bloc alfabètic i el caràcter «&» per a tornar a emprar-los en l'operació de substitució. Aleshores hem substituït la part coincident de la nostra línia per un espai en blanc seguit de const seguit d'un espai en blanc seguit del nostre bloc alfabètic (\1) seguit d'un espai en blanc seguit del nostre caràcter «&» emmagatzemat (\2)
En alguns casos el bloc alfabètic era String, en d'altres int, de manera que emprant la classe de caràcter \w i el quantificador + ens ha proveït d'un valuós actiu.
sort
	Ordena el text seleccionat o tot el document.
natsort
	Ordena el text seleccionat o tot el document de forma natural.

sort vs. natsort
sort(a10, a1, a2) resulta en a1, a10, a2
natsort(a10, a1, a2) resulta en a1, a2, a10
moveLinesDown
	Mou cap avall les línies seleccionades.
moveLinesUp
	Mou cap amunt les línies seleccionades.
uniq
	Elimina les línies duplicades del text seleccionat o de tot el document.
rtrim
	Elimina els espais finals del text seleccionat o de tot el document.
ltrim
	Elimina els espais al començament del text seleccionat o de tot el document.
join separador CADENA
	Uneix les línies seleccionades o tot el document. De manera opcional pren un paràmetre definint un separador, per exemple: join ', '
rmblank
	Elimina tots els espais en blanc del text seleccionat o de tot el document.
alignon
	 Aquesta ordre alinea les línies del bloc seleccionat o de tot el document a la columna indicada per una expressió regular proporcionada com a argument.
Si proporcioneu un patró buit, s'alinearà al primer caràcter no blanc de manera predeterminada.
Si el patró té una captura, se sagnarà en la coincidència capturada.
Exemples:
alignon - inserirà espais abans del primer «-» de cada línia per a alinear-les totes a la mateixa columna.
alignon :\\s+(.) inserirà espais abans del primer caràcter no blanc que hi hagi després de dos punts (:) per a alinear-les totes a la mateixa columna.
unwrap
	Ajusta les línies del text seleccionat o de tot el document.
each CADENA script
	Dona una funció de com un argument, aquesta crida a la llista de línies seleccionades i les substitueix pel valor retornat per aquesta crida.

Unir les línies seleccionades
each 'function(lines){return lines.join(", ")}'
O, més curt:
each 'lines.join(", ")'
filter CADENA script
	Dona una funció de com un argument, aquesta crida a la llista de línies seleccionades i elimina les que el valor retornat és «false».

Elimina les línies buides
filter 'function(1){return 1.length > 0;}'
O, més curt:
filter 'line.length > 0'
map CADENA script
	Dona una funció de com un argument, aquesta crida a la llista de línies seleccionades i substitueix la línia amb el valor de la crida.

Elimina les línies buides
map 'function(line){return line.replace(/^s+/,"");}'
O, més curt:
map 'line.replace(/^s+/,"")'
duplicateLinesUp
	Duplica les línies seleccionades per sobre de la selecció actual.
duplicateLinesDown
	Duplica les línies seleccionades per sota de la selecció actual.

Ordres per a navegar
goto ENTER línia
	Aquesta ordre va a la línia especificada.
grep CADENA patró
	Cercar al document per al patró d'expressió regular. Per a més informació, vegeu .
find CADENA patró
	Aquesta ordre navega fins a la primera ocurrència del patró d'acord amb la configuració. Les següents ocurrències es poden trobar utilitzant Edita Cerca la següent (la drecera predeterminada és F3).
L'ordre «find» pot configurar-se afegint dos punts seguits per una o més opcions, el format serà find:opcions patró. Estan suportades les següents opcions:
b 	Cerca enrere.
c 	Cerca des de la posició del cursor.
e 	Cerca només en el text seleccionat.
r 	Cerca utilitzant una expressió regular. Si està establerta, podeu utilitzar \N a on N serà un número per a representar captures en la cadena de substitució.
s 	Cerca distingint entre majúscules i minúscules.
w 	Només coincidiran paraules senceres.
ifind CADENA patró
	Aquesta ordre proveeix cerca quan-escriviu. Podeu configurar-ne el comportament o la cerca afegint dos punts seguits per a una o més opcions, de forma similar a: ifind:patró d'opcions. Les opcions permeses són:
b 	Cerca enrere.
r 	Cerca mitjançant expressions regulars.
s 	Cerca distingint entre majúscules i minúscules.
c 	Cerca des de la posició del cursor.

Ordres per a les funcions bàsiques de l'editor (aquestes depenen de l'aplicació, el component d'edició s'utilitza en)
w
	Desa el document actual.
wa
	Desa tots els documents oberts.
q
	Tanca el document actual.
qa
	Tanca tots els documents oberts.
wq
	Tanca i desa el document obert.
wqa
	Tanca i desa tots els documents oberts.
x
	Desa el document actual només si ha canviat i després el tanca.
x
	Desa tots els documents oberts només si han canviat i després els tanca.
bp
	Va al document anterior en la llista de documents.
bn
	Va al document següent en la llista de documents.
new
	Obre un document nou en una vista dividida horitzontal.
vnew
	Obre un document nou en una vista dividida vertical.
e
	Torna a carregar el document actual si ha canviat al disc.
enew
	Edita un document nou.
print
	Obre el diàleg d'impressió per a imprimir el document actual.

Usar el plegat del codi
El plegat del codi permet ocultar parts d'un document en l'editor, facilitant la visió de documents grans. A la , les regions plegables es calculen utilitzant regles definides en les definicions de ressaltat de la sintaxi, i per tant només està disponible en alguns formats (típicament codi font de programes, com ara el de marques XML i similars). La majoria de les definicions de ressaltat suporten plegat del codi i també permeten definir manualment regions plegables, generalment utilitzant les paraules clau BEGIN i END.
Per a utilitzar la característica de plegat del codi, activeu els marcadors plegables utilitzant l'element Visualitza Mostra els marcadors plegables del menú si no estan visibles. La subfinestra dels marcadors plegables a la part esquerra de la pantalla mostra una vista gràfica de les regions plegables, amb els símbols de triangle per a indicar la possible operació sobre una certa regió: Un triangle cap avall vol dir que la regió està desplegada, fent clic sobre seu es plegarà i es mostrarà un triangle apuntant cap a la dreta.
Es proveeixen tres ordres per a manipular l'estat de les regions plegables, vegeu la documentació del menú.
Les línies de plegat es recorden quan es tanca un fitxer, de manera que quan el torneu a obrir els nodes plegats encara ho estaran. Això també s'aplica a les operacions de tornar a carregar.
Si no voleu utilitzar la característica de plegat del codi, podeu desactivar l'opció Mostra els marcadors plegables (si estan disponibles) a la pàgina Aparença de la configuració de l'editor.