seek( ) 函数

示例 请参阅

在一个已建立索引的表中搜索一个记录的第一次出现位置，该记录的索引关键字与指定表达式相匹配。seek( ) 函数返回一个逻辑值，指示搜索是否成功。

语法

SEEK(eExpression [, nWorkArea | cTableAlias
[, nIndexNumber | cIDXIndexFileName | cTagName]])

参数
eExpression

指定 seek( ) 函数搜索的索引关键字表达式。

nWorkArea

指定要在其中搜索索引关键字的表所在工作区的编号。

cTableAlias

指定要搜索的表的别名。
如果省略了 nWorkArea 或 cTableAlias ，则在当前工作区中搜索表。

nIndexNumber

指定用来搜索关键字的索引文件或索引标识编号。
nIndexNumber 指出了索引文件在 USE 和 SET INDEX 命令中列出的编号。首先，按照 USE 或 SET INDEX 中的顺序对打开的 .IDX 文件进行编号。然后，对结构 .CDX 文件(如果存在)中的标识进行编号，其顺序与创建它们的顺序相同。最后，对所有打开的独立 .CDX 文件进行编号，其顺序也与创建的顺序相同。有关索引编号的详细内容，请参阅 SET ORDER。

cIDXIndexFileName

指定用来搜索索引关键字的 .IDX 文件。

cTagName

指定用来搜索索引关键字的 .CDX 文件的标识。标识名称可以来自结构文件 .CDX ，也可以来自任何打开的独立 .CDX 文件。

附注
如果存在相同的 .IDX 文件和标识名称，优先使用 .IDX 文件。

返回值类型

逻辑型

说明

只能对设置了索引次序的表使用 seek( ) 函数，并且只能搜索索引关键字。除非 SET EXACT 的设置为 OFF 时，否则所指的匹配是完全相匹配。
如果找到了匹配的记录，则 seek( ) 函数返回“真”(.T.)，记录指针指到找到的记录。如果找不到匹配记录，SEEK( ) 函数返回“假”(.F.)。此时记录指针移到文件的结尾。执行 seek( ) 函数同先执行 SEEK 命令然后执行 FOUND( ) 函数的结果一样。
如果省略了 nIndexNumber， IDXIndexFileName 和 cTagName 参数，那么 seek( ) 函数使用主控索引或索引标识来搜索索引关键字。