locate 命令

使用 locate 命令来将光标移至文档中的指定元素、行、标记、序号或序列文本。

语法

locate [ emphasis ] { element n
                    | line n
                    | mark {name | #id}
                    | sequenceNumber n
                    | [ all ] sequenceText textSpec
                    } 

参数

emphasis 使用 emphasis 参数来指示在找到目标时应对其进行强调。
element n 使用 element 参数来将光标移至指定的元素。n 必须是正整数。元素既包括显示行也包括非显示文档行。
line n 使用 line 参数来将光标移至指定的文档行。n 必须是正整数。文档行不包括显示行。
mark {name | #id} 使用 mark 参数来将光标移至指定的标记。可以通过标记的名称或其标识来指示标记。id 必须是正整数。
sequenceNumber n 使用 sequenceNumber 参数来将光标移至具有指定序号的行。n 必须是正整数。
all 使用可选的 all 参数来指示应定位所查找的序号文本部分的所有出现。
sequenceText
textSpec
使用 sequenceText 参数来将光标移至具有指定序号文本部分的行。要定位的文本部分由 textSpec 中的一个或多个参数指定,如下所示:

  string1 [ to string2 [ string3 [ to string4 ]]]

可指定一个或两个字符串范围。在此情况下,此命令将搜索带有序号文本部分(该文本部分在字典编辑方面介于任一范围中的给定字符串之间)的行。当只指定了一个字符串时,将执行精确匹配搜索。

除非指定了 all 参数,否则只对可视行执行搜索。

状态

status 参数将被设置为下列其中一项:
null locate 命令成功地找到指定的项。
locate.wrapped locate 命令成功地找到指定的序号文本部分,但在搜索期间必须回绕至文档的开头。
locate.notFound 找不到指定的项。
locate.noSequenceText 指示没有在文档中设置序号文本部分。

示例

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

相关概念
编辑器命令、操作和参数

相关参考
element 参数
elements 参数
emphasisLength 参数
line 参数
lines 参数
mark 参数
markId 参数
sequenceNumber 参数
sequenceNumbers 参数
sequenceText 参数
status 参数
findMark 操作
findQuickMark 操作
locateLine 操作