Commande findText

Utilisez la commande findText pour localiser et éventuellement remplacer du texte dans un document.

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 | selection }
           | wholeWord
           | noWrap
           | asis
           | noEmphasis
           | regularExpression
           | replaceWith texte de remplacement
           ] [...]
           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 que la recherche ne se poursuive.
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 recherche aux colonnes de début et de fin spécifiées.  col1 et col2 doivent être des nombres entiers positifs.
block | selection Utilisez le paramètre facultatif block ou selection pour limiter la recherche à la sélection de bloc en cours.
wholeWord Utilisez le paramètre facultatif wholeWord pour limiter la recherche aux mots entiers.  Les mots se composent de lettres, de chiffres et de traits de soulignement.
noWrap Utilisez le paramètre facultatif noWrap pour indiquer que la recherche doit s'arrêter lorsque la fin du document est atteinte.  Dans le cas d'une recherche vers le haut du document, le paramètre noWrap indique que la recherche s'arrêtera lorsque le début du document sera atteint.
asis Utilisez le paramètre facultatif asis pour indiquer que la recherche doit être sensible à la casse.
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 texte de remplacement Utilisez le paramètre facultatif replaceWith pour indiquer que le texte trouvé doit être remplacé par le texteDeRemplacement.  Si le texteDeRemplacement contient des espaces, vous devez le faire précéder de guillemets (").  Si le texteDeRemplacement contient des guillemets, vous devez les faire précéder d'une barre oblique inversée (\").  Si le texteDeRemplacement contient des barres obliques inversées, vous devez les faire précéder d'une 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 indiqués par la commande findText.

Etat

L'une des valeurs suivantes est affectée au paramètre status :
null Le texte spécifié a été trouvé sans conditions particulières.
findText.onlyOccurrence 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 La commande findText a trouvé 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 le début du document, elle a dû aller à la fin du document au cours de la recherche.
findText.notFound Le texte spécifié est introuvable.
findText.invalidPattern Le texte spécifié n'est pas un modèle d'expression régulière valide.  Cet état s'affiche uniquement 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 vous permettent de rechercher un texte qui correspond à un modèle que vous avez défini.  L'éditeur prend en charge les expressions régulières du langage Java.  Cependant, la commande findText agit ligne par ligne.

La liste ci-dessous répertorie quelques-uns des modèles d'expressions régulières les plus courants :

c Si c n'est pas un caractère spécial, établir une correspondance avec une instance unique de ce caractère.
\c Etablir une correspondance avec une instance unique du caractère c qui serait sinon interprété comme un caractère spécial.  Par exemple, l'expression \\ correspond à une seule barre oblique inversée et l'expression \[ correspond à un crochet ouvrant.
\t Tabulation ('\u0009').
\xhh Un caractère dont la valeur hexadécimale est 0xhh.  Chaque h représente un chiffre hexadécimal.
\uhhhh Un caractère dont la valeur hexadécimale est 0xhhhh.  Chaque h représente un chiffre hexadécimal.
. Etablir une correspondance avec tout caractère unique.
[abc] Etablir une correspondance avec tout caractère unique inclus dans abc.
[^abc] Etablir une correspondance avec tout caractère unique sauf ceux qui sont inclus dans abc.
[a-z] Etablir une correspondance avec tout caractère unique compris entre a et z.
[^a-z] Etablir une correspondance avec tout caractère unique sauf ceux qui sont compris entre a et z.
[a-zA-Z] Etablir une correspondance avec tout caractère unique compris entre a et z ou A et Z.
\d Un chiffre.  Cette expression correspond à [0-9].
\D Un caractère autre qu'un chiffre.  Cette expression correspond à [^0-9].
\s Un caractère blanc.  Cette expression correspond à [ \t\x0A\x0B\x0C\x0D].
\S Un caractère autre qu'un espace blanc.  Cette expression correspond à [^\s].
\w Un caractère alphanumérique.  Cette expression correspond à [a-zA-Z0-9_].
\W Un caractère non alphanumérique.  Cette expression correspond à [^\w].
^ Etablir une correspondance avec le début d'une ligne.  ^ doit être le premier caractère de l'expression.
$ Etablir une correspondance avec la fin d'une ligne.  $ doit être le dernier caractère de l'expression.
\b Etablir une correspondance avec la limite d'un mot.
\B Etablir une correspondance avec une limite autre que celle d'un mot.
X? Etablir une correspondance avec zéro ou une occurrence de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X* Etablir une correspondance avec zéro ou plusieurs occurrences successives de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X+ Etablir une correspondance avec une ou plusieurs occurrences successives de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X{n} Etablir une correspondance exacte avec n occurrences successives de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X{n,} Etablir une correspondance avec au moins n occurrences successives de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X{n,m} Etablir une correspondance avec au moins n mais pas plus de m occurrences successives de l'expression X.  Trouver la correspondance la plus longue (correspondance gourmande).
X?? Etablir une correspondance avec zéro ou une occurrence de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
X*? Etablir une correspondance avec zéro ou plusieurs occurrences successives de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
X+? Etablir une correspondance avec une ou plusieurs occurrences successives de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
X{n}? Etablir une correspondance exacte avec n occurrences successives de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
X{n,}? Etablir une correspondance avec au moins n occurrences successives de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
X{n,m}? Etablir une correspondance avec au moins n mais pas plus de m occurrences successives de l'expression X.  Trouver la correspondance la plus courte (correspondance non gourmande).
XY Etablir une correspondance avec l'expression X suivie de l'expression Y.
X|Y Etablir une correspondance soit avec l'expression X soit avec l'expression Y.

Exemples

findText "texte"
findText replaceWith "nouveau texte" "texte"
findText up
findText regularExpression "ceci|cela" 

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

Références connexes
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.incremental
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 status
Paramètre topExpanded
Paramètre visible

Action excludeSelection
Action filterSelection
Action find
Action findAndReplace
Action findAndReplaceNext
Action findAndReplaceUp
Action findNext
Action findSelection
Action findUp
Modèles d'expressions régulières Java