idxcollate( ) 函数

示例 请参阅

返回索引或索引标识的排序序列。

语法

IDXCOLLATE([cCDXFileName,] nIndexNumber [, nWorkArea | 
cTableAlias])

参数

cCDXFileName

指定复合索引文件名。该复合索引文件可以是随表自动打开的结构复合索引文件，也可以是独立的复合索引文件。

nIndexNumber

指定索引或索引标识，IDXCOLLATE( ) 返回其排序序列。当 nIndexNumber 从 1 递增到打开的索引文件和索引标识总数时，IDXCOLLATE( ) 按如下次序返回索引或索引标识的排序序列：

1. 首先返回单项索引 .IDX 文件(如果有此类文件打开)的排序序列，返回的排序序列取决于 USE 或 SET INDEX 中包含的单项索引文件的序列。
2. 然后返回结构复合索引(如果存在)中标识的排序序列，标识的排序序列按照标识在结构复合索引中创建的次序返回。
3. 最后返回打开的独立复合索引中标识的排序序列，标识的排序序列按照标识在独立的复合索引中创建的序列返回。

如果 nIndexNumber 大于打开的单项索引文件、结构复合索引标识和独立的复合索引标识的总数目，则返回空字符串。

nWorkArea

指定表的工作区，idxcollate( ) 函数返回该表的索引文件和索引标识的排序序列。
如果指定的工作区中没有打开的表，idxcollate( ) 函数将返回空字符串。

cTableAlias

指定表的别名，IDXCOLLATE( ) 返回该表的索引文件和索引标识的排序序列。
如果指定的表别名不存在，Visual FoxPro 产生错误信息。

返回值类型
字符型

说明
idxcollate( ) 函数可以返回多项复合索引文件中每一标识的排序序列，这样只需使用一系列的 SET COLLATE 和 INDEX 命令，就可以完全删除一个索引文件，然后再正确地重建这个索引文件。
注意：REINDEX 的某些功能并不需要 IDXCOLLATE( )，因为其排序序列信息已经存放在索引和索引标识中。
有关 Visual FoxPro 国际支持方面的其他内容，请参阅《开发指南》第二十章“开发国际应用程序”。