Commande locate

La commande locate permet de déplacer la curseur vers l'élément, la ligne, la marque, le numéro de séquence ou la séquence de texte spécifiés dans le document.

Syntaxe

locate [ emphasis ] { element n
                    | line n
                    | mark {nom | #id}
                    | sequenceNumber n
                    | [ all ] sequenceText spécTexte
                    } 

Paramètres

emphasis Le paramètre emphasis permet de préciser que la cible doit être mise en évidence lorsqu'elle a été trouvée.
element n Le paramètre element permet de déplacer le curseur vers l'élément spécifié. n doit être un entier supérieur à zéro. Les éléments incluent les lignes show et les lignes de document non show.
line n Le paramètre line permet de déplacer le curseur vers la ligne de document spécifiée. n doit être un entier supérieur à zéro. Les lignes du document n'incluent pas les lignes show.
mark {nom | #id} Le paramètre mark permet de déplacer le curseur vers la marque spécifiée. Une marque peut être indiquée par son nom ou par son ID. Le paramètre id doit être un entier supérieur à zéro.
sequenceNumber n Le paramètre sequenceNumber permet de déplacer le curseur vers la ligne détenant le numéro de séquence spécifié. n doit être un entier supérieur à zéro.
all Utilisez le paramètre facultatif all pour indiquer que toutes les occurrences de la partie textuelle des numéros de séquence recherchés doivent être localisées.
sequenceText
spécTexte
Le paramètre sequenceText permet de déplacer le curseur vers la ligne détenant la partie textuelle des numéros de séquence spécifiés. La partie textuelle à localiser est indiquée par un ou plusieurs paramètres de spécTexte, comme suit :

chaîne1 [ to chaîne2 [ chaîne3 [ to chaîne4 ]]]

Un ou deux intervalles de chaîne doivent être spécifiés ; dans ce cas, la commande recherche une ligne dont la partie textuelle des numéros de séquence se trouve, en termes lexicographiques, entre les chaînes données dans chaque intervalle. Une recherche par occurrence exacte est uniquement lancée lorsqu'une seule chaîne est indiquée.

Sauf si le paramètre all est spécifié, la recherche ne porte que sur les lignes visibles.

Etat

La valeur du paramètre status peut être :
null La commande locate a trouvé l'élément spécifié.
locate.wrapped La commande locate a trouvé la partie textuelle des numéros de séquence spécifiés, mais elle a dû revenir au début du document au cours de la recherche.
locate.notFound L'élément spécifié est introuvable.
locate.noSequenceText Indique qu'aucune partie textuelle des numéros de séquence n'a été définie dans le document.

Exemples

locate emphasis element 100
locate mark a
locate sequenceText 041201 to 041231 

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

Références connexes
Paramètre element
Paramètre elements
Paramètre emphasisLength
Paramètre line
Paramètre lines
Paramètre mark
Paramètre markId
Paramètre sequenceNumber
Paramètre sequenceNumbers
Paramètre sequenceText
Paramètre status
Action findMark
Action findQuickMark
Action locateLine