Commande findText

La commande findText permet de rechercher du texte dans un document, et éventuellement de le remplacer.

Les paramètres de la commande findText se divisent en deux groupes.

Syntaxe

findText [ up
| checkStart
| replace
| all
| quiet
| noBeep
         ] [...]
[ [ mark
| columns col1 col2
| block
| wholeWord
| noWrap
| asis
| noEmphasis
| regularExpression
| replaceWith texteRemplacement
           ] [...]
texte
         ] 

Paramètres

up Utilisez le paramètre facultatif up pour indiquer que la recherche doit s'effectuer vers l'arrière à partir de l'emplacement en cours.
checkStart Utilisez le paramètre facultatif checkStart pour indiquer que l'emplacement en cours du curseur doit être vérifié avant de poursuivre la recherche.
replace Utilisez le paramètre facultatif replace pour indiquer que le texte trouvé doit être remplacé par le texte indiqué par le paramètre findText.replaceText.
all Utilisez le paramètre facultatif all pour indiquer que toutes les occurrences du texte recherché doivent être localisées. La recherche ignore l'emplacement actuel du curseur et respecte les restrictions block et columns.
quiet Utilisez le paramètre facultatif quiet pour indiquer qu'aucun message ou signal sonore ne doit être émis.
noBeep Utilisez le paramètre facultatif noBeep pour indiquer qu'aucun signal sonore ne doit être émis.
mark Utilisez le paramètre facultatif mark pour indiquer que le texte trouvé doit être sélectionné.
columns col1 col2 Utilisez le paramètre facultatif columns pour limiter la portée de la recherche aux colonnes de début et de fin spécifiées. col1 et col2 doivent être des nombres entiers positifs.
block Utilisez le paramètre facultatif block pour limiter la portée de la recherche à la sélection de bloc en cours.
wholeWord Utilisez le paramètre facultatif wholeWord pour restreindre la recherche aux mots entiers. Les mots peuvent comprendre des lettres, des chiffres et des traits de soulignement.
noWrap Utilisez le paramètre facultatif noWrap pour indiquer que la recherche s'arrête lorsque la fin du document est atteinte. Dans le cas d'une recherche vers l'arrière, le paramètre noWrap indique que la recherche s'arrête lorsque le début du document est atteint.
asis Utilisez le paramètre facultatif asis pour indiquer que la recherche doit faire la distinction entre les majuscules et les minuscules.
noEmphasis Utilisez le paramètre facultatif noEmphasis pour indiquer que le texte trouvé ne doit pas être mis en évidence à l'aide du style approprié dans la vue du document.
regularExpression Utilisez le paramètre facultatif regularExpression pour indiquer que la chaîne de recherche doit être traitée comme un modèle d'expression régulière.
replaceWith texteRemplacement Utilisez le paramètre facultatif replaceWith pour indiquer que le texte trouvé doit être remplacé par texteRemplacement.Si texteRemplacement contient des espaces, il doit être précédé de guillemets (").Si texteRemplacement contient lui-même des guillemets, ils doivent être précédés d'une barre oblique inversée (\").Si texteRemplacement contient des barres obliques inversées, ils doivent être précédés d'une autre barre oblique inversée (\\).
texte Utilisez le paramètre texte pour indiquer le texte à rechercher. Il peut s'avérer nécessaire de placer la chaîne entre guillemets, si vous recherchez l'un des mots clés findText.

Etat

La valeur du paramètre status peut être :
null Indique que la commande findText a localisé le texte spécifié sans conditions spécifiques.
findText.onlyOccurrence Indique que la commande findText a effectué la recherche dans la totalité du document, est revenue au début et a localisé le texte spécifié à l'emplacement d'origine du curseur.
findText.wrapped Indique que la commande findText a localisé le texte spécifié, mais a dû revenir au début du document au cours de la recherche. Si la recherche s'est effectuée vers l'arrière, elle est allée à la fin du document au cours de la recherche.
findText.notFound Indique que le texte spécifié est introuvable.
findText.invalidPattern Indique que le texte spécifié n'est pas un modèle d'expression régulière valide. Cet état ne peut être défini que si vous avez indiqué que le texte spécifié est un modèle d'expression régulière.

Description

La commande findText utilise les paramètres suivants :

Sauf si le paramètre all est spécifié, la commande findText affecte uniquement les éléments visibles.

Les expressions régulières permettent de rechercher un texte correspondant à un modèle que vous spécifiez.   Les expressions régulières prises en charge dans l'éditeur sont définies par le langage Java.   Toutefois, la commande findText examine une ligne après l'autre.

Vous trouverez ci-après quelques modèles d'expressions régulières.

c Si c n'est pas un caractère spécial, rechercher une seule instance de ce caractère.
\c Permet de rechercher une seule instance du caractère c qui serait autrement considéré comme un caractère spécial.   Par exemple, l'expression \\ correspond à une barre oblique inverse unique et l'expression \[ correspond à un crochet ouvrant.
\t Caractère de tabulation ('\u0009').
\xhh Caractère avec valeur hexadécimale 0xhh.  Chaque h représente un chiffre hexadécimal.
\uhhhh Caractère avec valeur hexadécimale 0xhhhh.  Chaque h représente un chiffre hexadécimal.
. Permet de rechercher un caractère unique.
[abc] Permet de rechercher l'un des caractères inclus dans la chaîne abc.
[^abc] Permet de rechercher tout caractère à l'exception de ceux inclus dans la chaîne abc.
[a-z] Permet de rechercher tous les caractères compris entre a et z.
[^a-z] Permet de rechercher tous les caractères à l'exception de ceux compris entre a et z.
[a-zA-Z] Permet de rechercher tous les caractères compris entre a et z ou A et Z.
\d Chiffre.  Equivaut à [0-9].
\D Caractère autre qu'un chiffre.  Equivaut à [^0-9].
\s Espace.   Equivaut à [ \t\x0A\x0B\x0C\x0D].
\S Caractère autre qu'un espace.   Equivaut à [^\s].
\w Caractère alphanumérique  Equivaut à [a-zA-Z0-9_].
\W Caractère non alphanumérique.   Equivaut à [^\w].
^ Permet de rechercher le premier caractère d'une ligne.   ^ doit être le premier caractère de l'expression.
$ Permet de rechercher le dernier caractère d'une ligne.   $ doit être le dernier caractère de l'expression.
\b Permet de rechercher une frontière de mot.
\B Permet de rechercher une frontière différente d'une frontière de mot.
X? Permet de rechercher une occurrence de l'expression X ou n'affiche aucune occurrence.  L'occurrence la plus longue est recherchée (occurrence étendue).
X* Permet de rechercher une suite d'occurrences de l'expression X ou n'affiche aucune occurrence.  L'occurrence la plus longue est recherchée (occurrence étendue).
X+ Permet de rechercher une ou plusieurs occurrences successives de l'expression X.  L'occurrence la plus longue est recherchée (occurrence étendue).
X{n} Permet de rechercher précisément n occurrences successives de l'expression X.  L'occurrence la plus longue est recherchée (occurrence étendue).
X{n,} Permet de rechercher au moins n occurrences successives de l'expression X.  L'occurrence la plus longue est recherchée (occurrence étendue).
X{n,m} Permet de rechercher au moins n occurrences successives de l'expression X mais pas plus de m.  L'occurrence la plus longue est recherchée (occurrence étendue).
X?? Permet de rechercher une occurrence de l'expression X ou n'affiche aucune occurrence.  L'occurrence la plus courte est recherchée (occurrence non étendue).
X*? Permet de rechercher une suite d'occurrences de l'expression X ou n'affiche aucune occurrence.  L'occurrence la plus courte est recherchée (occurrence non étendue).
X+? Permet de rechercher une ou plusieurs occurrences successives de l'expression X ou n'affiche aucune occurrence.  L'occurrence la plus courte est recherchée (occurrence non étendue).
X{n}? Permet de rechercher précisément n occurrences successives de l'expression X.  L'occurrence la plus courte est recherchée (occurrence non étendue).
X{n,}? Permet de rechercher au moins n occurrences successives de l'expression X.  L'occurrence la plus courte est recherchée (occurrence non étendue).
X{n,m}? Permet de rechercher au moins n occurrences successives de l'expression X mais pas plus de m.  L'occurrence la plus courte est recherchée (occurrence non étendue).
XY Permet de rechercher l'expression X suivie de l'expression Y.
X|Y Permet de rechercher l'expression X ou Y.

Exemples

findText "texte"
findText replaceWith "nouveau texte" "texte"
findText up
findText regularExpression "this|that" 

Concepts connexes
Commandes, actions et paramètres de l'éditeur

Références
Paramètre emphasisLength
Paramètre expandHide
Paramètre expanded
Paramètre findText.asis
Paramètre findText.block
Paramètre findText.columns
Paramètre findText.emphasis
Paramètre findText.endColumn
Paramètre findText.findText
Paramètre findText.mark
Paramètre findText.regularExpression
Paramètre findText.replaceText
Paramètre findText.startColumn
Paramètre findText.wholeWord
Paramètre findText.wrap
Paramètre topExpanded
Paramètre visible
Action filterSelection
Action find
Action findAndReplace
Action findAndReplaceNext
Action findAndReplaceUp
Action findNext
Action findSelection
Action findUp
Commandes de l'éditeur par défaut
Modèles d'expression régulière Java