Mit dem Befehl locate können Sie den Cursor zum angegebenen Element, zur angegebenen Zeile, Markierung, Folgenummer oder zum angegebenen Folgetext im Dokument bewegen.
locate [ emphasis ] { element n | line n | mark {Name | #ID} | sequenceNumber n | [ all ] sequenceText Textspez. }
emphasis | Mit dem Parameter emphasis können Sie angeben, dass das Ziel hervorgehoben werden soll, wenn es gefunden wird. |
element n | Mit dem Parameter element können Sie den Cursor auf das angegebene Element setzen. n muss eine positive ganze Zahl sein. Elemente enthalten sowohl Dokumentzeilen, die angezeigt werden, als auch Dokumentzeilen, die nicht angezeigt werden. |
line n | Mit dem Parameter line können Sie den Cursor zur angegebenen Dokumentzeile bewegen. n muss eine positive ganze Zahl sein. Dokumentzeilen enthalten keine Anzeigezeilen. |
mark {Name | #ID} | Mit dem Parameter mark können Sie den Cursor auf die angegebene Markierung setzen. Eine Markierung kann mit ihrem Namen oder mit ihrer ID angegeben werden. ID muss eine positive ganze Zahl sein. |
sequenceNumber n | Mit dem Parameter sequenceNumber können Sie den Cursor auf die Zeile mit der angegebenen Folgenummer setzen. n muss eine positive ganze Zahl sein. |
all | Mit dem optionalen Parameter all können Sie angeben, dass alle Vorkommen des gesuchten Textes (Folgenummern) lokalisiert werden sollen. |
sequenceText Textspez. |
Mit dem Parameter sequenceText können Sie den Cursor auf die
Zeile mit der angegebenen Textkomponente zwischen den Folgenummern setzen. Die zu lokalisierende Textkomponente
wird durch einen oder mehrere Parameter in Textspez. wie
folgt angegeben:
Zeichenfolge1 [ to Zeichenfolge2 [ Zeichenfolge3 [ to Zeichenfolge4 ]]] Es können ein oder zwei Zeichenfolgebereiche angegeben werden; in diesem Fall sucht der Befehl nach einer Zeile mit einer Textkomponente, die lexikographisch zwischen den angegebenen Zeichenfolgen in einem der Bereiche liegt. Wird nur eine einzige Zeichenfolge angegeben, wird eine Suche mit exakter Übereinstimmung ausgeführt.Sofern der Parameter all nicht angegeben wurde, wird die Suche nur für die sichtbaren Zeilen ausgeführt. |
Der Parameter status wird auf einen der folgenden Werte gesetzt:
null Der Befehl locate hat den angegebenen Text gefunden. locate.wrapped Der Befehl locate hat die angegebene Textkomponente zwischen den Folgenummern gefunden, aber während der Suche musste ein Umlauf an den Anfang des Dokuments erfolgen. locate.notFound Der angegebene Text wurde nicht gefunden. locate.noSequenceText Gibt an, dass keine Textkomponente zwischen Folgenummern in dem Dokument definiert wurde.
locate emphasis element 100 locate mark a locate sequenceText 041201 to 041231
Editorbefehle, Aktionen und Parameter
Parameter element
Parameter elements
Parameter emphasisLength
Parameter line
Parameter lines
Parameter mark
Parameter markId
Parameter sequenceNumber
Parameter sequenceNumbers
Parameter sequenceText
Parameter status
Aktion findMark
Aktion findQuickMark
Aktion locateLine
Copyright IBM Corporation 1992, 2004. Alle Rechte vorbehalten.