Befehl findText

Verwenden Sie den Befehl findText, um Text in einem Dokument zu lokalisieren und wahlweise zu ersetzen.

Die Parameter für den Befehl findText sind in zwei Gruppen unterteilt:

Syntax

findText [ up
         | checkStart
         | replace
         | all
         | quiet
         | noBeep
         ] [...]
         [ [ mark
           | columns Spalte1 Spalte2
           | { block | selection }
           | wholeWord
           | noWrap
           | asis
           | noEmphasis
           | regularExpression
           | replaceWith Ersatztext
           ] [...]
           Text
         ] 

Parameter

up Verwenden Sie den optionalen Parameter up, um anzugeben, dass die Suche von der aktuellen Position aus rückwärts erfolgen soll.
checkStart Verwenden Sie den optionalen Parameter checkStart, um anzugeben, dass die aktuelle Cursorposition überprüft werden soll, bevor mit der Suche fortgefahren wird.
replace Verwenden Sie den optionalen Parameter replace, um anzugeben, dass der gefundene Text durch den Text ersetzt werden soll, der durch den Parameter findText.replaceText angegeben ist.
all Verwenden Sie den optionalen Parameter all, um anzugeben, dass alle Vorkommen des gesuchten Textes lokalisiert werden sollen.  Die Suche ignoriert die aktuelle Cursorposition, berücksichtigt aber die Einschränkungen für block (Block) und columns (Spalten).
quiet Verwenden Sie den optionalen Parameter quiet, um anzugeben, dass keine Nachrichten oder Audiorückmeldungen ausgegeben werden sollen.
noBeep Verwenden Sie den optionalen Parameter noBeep, um anzugeben, dass keine Audiorückmeldungen ausgegeben werden sollen.
mark Verwenden Sie den optionalen Parameter mark, um anzugeben, dass der gefundene Text ausgewählt werden soll.
columns Spalte1 Spalte2 Verwenden Sie den optionalen Parameter columns, um den Bereich der Suche auf die angegebenen Anfangs- und Endspalten zu begrenzen.  Spalte1 und Spalte2 müssen positive ganze Zahlen sein.
block | selection Verwenden Sie den optionalen Parameter block bzw. selection, um den Bereich für die Suche auf die aktuelle Blockauswahl zu begrenzen.
wholeWord Verwenden Sie den optionalen Parameter wholeWord, um die Suche auf ganze Wörter zu begrenzen.  Wörter bestehen aus Buchstaben, Ziffern und Unterstreichungszeichen.
noWrap Verwenden Sie den optionalen Parameter noWrap, um anzugeben, dass die Suche gestoppt werden soll, wenn das Ende des Dokuments erreicht wird.  Wird das Dokument rückwärts durchsucht, gibt der Parameter noWrap an, dass die Suche gestoppt werden soll, wenn der Anfang des Dokuments erreicht wird.
asis Verwenden Sie den optionalen Parameter asis, um anzugeben, dass bei der Suche die Groß-/Kleinschreibung beachtet werden soll.
noEmphasis Verwenden Sie den optionalen Parameter noEmphasis, um anzugeben, dass der gefundene Text nicht mit dem Hervorhebungsstil der Dokumentsicht hervorgehoben werden soll.
regularExpression Verwenden Sie den optionalen Parameter regularExpression, um anzugeben, dass der Suchbegriff als Muster für einen regulären Ausdruck behandelt werden soll.
replaceWith Ersatztext Verwenden Sie den optionalen Parameter replaceWith, um anzugeben, dass der gefundene Text durch Ersatztext ersetzt werden soll.  Enthält Ersatztext Leerzeichen, müssen vor dem Text Anführungszeichen (") eingefügt werden.  Enthält Ersatztext Anführungszeichen, muss vor den Anführungszeichen ein Backslash (\") eingefügt werden.  Enthält Ersatztext Backslashes, muss vor den Backslashes ein Backslash (\\) eingefügt werden.
Text Verwenden Sie den Parameter text, um den Text anzugeben, nach dem gesucht werden soll.  Sie müssen die Zeichenfolge möglicherweise in Anführungszeichen setzen oder mit umgekehrten Schrägstrichen versehen, wenn nach einem der Schlüsselwörter von findText gesucht wird.

Status

Der Parameter status wird auf einen der folgenden Werte gesetzt:
null Der angegebene Text wurde ohne spezielle Bedingungen erfolgreich lokalisiert.
findText.onlyOccurrence Der Befehl findText hat das gesamte Dokument durchsucht und den angegebenen Text an der ursprünglichen Cursorposition eingeschlossen und lokalisiert.
findText.wrapped Der Befehl findText hat den angegebenen Text erfolgreich lokalisiert, aber während der Suche musste ein Umlauf an den Anfang des Dokuments erfolgen.  Wurde die Suche rückwärts durchgeführt, musste während des Suchvorgangs ein Umlauf an das Ende des Dokuments erfolgen.
findText.notFound Der angegebene Text konnte nicht gefunden werden.
findText.invalidPattern Der angegebene Text ist kein gültiges Muster für einen regulären Ausdruck.  Dieser Status darf nur definiert werden, wenn angegeben wurde, dass der angegebene Text ein Muster für einen regulären Ausdruck ist.

Beschreibung

Der Befehl findText verwendet die folgenden Parameter:

Sofern der Parameter all nicht angegeben wurde, hat der Befehl findText nur auf sichtbare Elemente Auswirkungen.

Reguläre Ausdrücke ermöglichen Ihnen das Auffinden von Text, der mit einem von Ihnen angegebenen Verhaltensmuster übereinstimmt.  Die Unterstützung regulärer Ausdrücke im Editor wird durch die Sprache Java zur Verfügung gestellt.  Sie sollten jedoch beachten, dass der Befehl findText auf Zeilenbasis funktioniert.

Nachfolgend einige allgemeine, regelmäßige reguläre Ausdrücke:

c Ist c kein Sonderzeichen, entspricht es einem einzelnen Exemplar dieses Zeichens.
\c Entspricht einem einzelnen Exemplar des Zeichens c, das andernfalls als Sonderzeichen interpretiert werden würde.  Beispiel: Der Ausdruck \\ entspricht einem einzelnen umgekehrten Schrägstrich und der Ausdruck \[ entspricht einer linken eckigen Klammer.
\t Das Tabulatorzeichen ('\u0009').
\xhh Das Zeichen mit dem Hexadezimalwert 0xhh.  Jedes h stellt eine hexadezimale Stelle dar.
\uhhhh Das Zeichen mit dem Hexadezimalwert 0xhhhh.  Jedes h stellt eine hexadezimale Stelle dar.
. Entspricht einem beliebigen Einzelzeichen.
[abc] Entspricht einem beliebigen Einzelzeichen, das in abc enthalten ist.
[^abc] Entspricht einem beliebigen Einzelzeichen, außer denjenigen Zeichen, die in abc enthalten sind.
[a-z] Entspricht einem beliebigen Einzelzeichen im Bereich a bis z.
[^a-z] Entspricht einem beliebigen Einzelzeichen, außer denjenigen Zeichen, die im Bereich a bis z enthalten sind.
[a-zA-Z] Entspricht einem beliebigen Einzelzeichen im Bereich a bis z oder A bis Z.
\d Eine Ziffer.  Äquivalent zu [0-9].
\D Eine Nicht-Ziffer.  Äquivalent zu [^0-9].
\s Ein Leerzeichen.  Äquivalent zu [ \t\x0A\x0B\x0C\x0D].
\S Ein Nicht-Leerzeichen.  Äquivalent zu [^\s].
\w Ein Wortzeichen (alphanumerisches Zeichen).  Äquivalent zu [a-zA-Z0-9_].
\W Ein Nicht-Wortzeichen.  Äquivalent zu [^\w].
^ Entspricht dem Anfang einer Zeile.  ^ muss das erste Zeichen im Ausdruck sein.
$ Entspricht dem Ende einer Zeile.  $ muss das letzte Zeichen im Ausdruck sein.
\b Entspricht einer Wortgrenze.
\B Entspricht einer Nicht-Wortgrenze.
X? Entspricht Null oder einem Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X* Entspricht Null oder mehreren aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X+ Entspricht einem oder mehreren aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X{n} Entspricht genau n aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X{n,} Entspricht mindestens n aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X{n,m} Entspricht mindestens n, aber nicht mehr als m aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die längste mögliche Übereinstimmung wird gefunden (greedy match).
X?? Entspricht Null oder einem Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
X*? Entspricht Null oder mehreren aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
X+? Entspricht einem oder mehreren aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
X{n}? Entspricht genau n aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
X{n,}? Entspricht mindestens n aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
X{n,m}? Entspricht mindestens n, aber nicht mehr als m aufeinanderfolgenden Vorkommen des Ausdrucks X.  Die kürzeste Übereinstimmung wird gefunden (non greedy match).
XY Entspricht Ausdruck X, gefolgt von Ausdruck Y.
X|Y Entspricht entweder Ausdruck X oder Y.

Beispiele

findText "Text"
findText replaceWith "neuer Text" "Text"
findText up
findText regularExpression "dies|das" 

Zugehörige Konzepte
Editorbefehle, Aktionen und Parameter

Zugehöriger Verweis
Parameter emphasisLength
Parameter expandHide
Parameter expanded
Parameter findText.asis
Parameter findText.block
Parameter findText.columns
Parameter findText.emphasis
Parameter findText.endColumn
Parameter findText.findText
Parameter findText.incremental
Parameter findText.mark
Parameter findText.regularExpression
Parameter findText.replaceText
Parameter findText.startColumn
Parameter findText.wholeWord
Parameter findText.wrap
Parameter status
Parameter topExpanded
Parameter visible

Aktion excludeSelection
Aktion filterSelection
Aktion find
Aktion findAndReplace
Aktion findAndReplaceNext
Aktion findAndReplaceUp
Aktion findNext
Aktion findSelection
Aktion findUp
Java-Muster regulärer Ausdrücke