SYS(2021) - 已筛选的索引表达式

请参阅

返回打开的单项索引文件 (.IDX) 的筛选表达式或复合索引文件 (.CDX) 中标识的筛选表达式。

语法

SYS(2021, nIndexNumber [, nWorkArea | cTableAlias])

返回值类型

字符型

参数
nIndexNumber

数值表达式 nIndexNumber 指定从打开的索引文件中返回哪一个筛选表达式。当 nIndexNumber 从 1 增加到打开的单项索引文件、结构复合索引以及独立的复合索引标识的总数时，
SYS(2021) 以下面的顺序从打开的索引文件中返回筛选表达式：

• 最先从单项索引文件中(如果打开)返回筛选表达式。包含在 USE 或 SET INDEX 命令中单项索引文件的顺序决定返回筛选表达式的顺序。
  
• 其次返回在结构复合索引文件(如果存在)中每个标识的筛选表达式。筛选表达式以结构复合索引中标识的创建顺序从标识中返回。
  
• 最后返回在任何独立的复合索引文件中每个标识的筛选表达式。筛选表达式以独立的复合索引中标识的创建顺序从标识中返回。

如果 nIndexNumber 大于打开的单项索引文件、结构索引文件标识以及独立的复合索引文件标识的总数时，返回一个空串。

nWorkArea

为另一个工作区中打开的表指定工作区编号。

cTableAlias

为另一个工作区中打开的表指定一个别名。如果表没有指定的别名，Visual FoxPro 将显示一条错误信息。

说明

可以在 Visual FoxPro 中创建已筛选的索引。如果在 INDEX 中包含可选的 FOR 子句，那么索引文件作为一个筛选条件作用在表上。在 FOR 子句只有满足筛选表达式 lexpression 的记录可以显示和访问。在索引文件中，为那些满足筛选表达式的记录创建索引关键字。
如果没有用 FOR 子句创建索引或索引标识，则返回一个空串。
USE 和 SET INDEX 命令都支持索引文件名列表，该列表可以为一个表打开多个索引文件。在索引文件名列表中可以包含任何单项索引文件名、结构复合索引文件和独立的复合索引文件名的组合。

除非指定特殊的工作区或别名，否则 SYS(2021) 从在当前工作区中打开的索引文件中返回筛选表达式。