tag( ) 函数

示例 请参阅

返回打开的 .CDX 多项复合索引文件的标识名，或者返回打开的 .IDX 单项索引文件的文件名。

语法

TAG([CDXFileName,] nTagNumber [, nWorkArea | cTableAlias])

参数
CDXFileName

指定多项复合索引文件 .CDX 的文件名，tag( ) 函数将返回该文件的一个标识名。

nTagNumber

指定一个数值，此数值对应于复合索引文件中标识的创建顺序。例如，如果 nTagNumber 是 1，tag( ) 函数将返回复合索引文件中创建的第一个标识名；如果 nTagNumber 是 2，tag( ) 函数将返回所创建的第二个标识名，依此类推。当 nTagNumber 超过标识总数时，tag( ) 函数将返回一个空字符串。
如果省略了 CDXFileName 参数，tag( ) 函数将按以下特定顺序返回复合索引文件的标识名和单项索引文件的文件名：

1. 依据它们在 SET INDEX 或 USE 的 INDEX 子句中出现的次序，返回单项索引文件的文件名。
   
2. 返回结构复合索引文件(如果该表存在这样的文件)标识名。
   
3. 返回其他打开的复合索引文件中的标识名。同样是按标识在复合索引文件中的创建次序和复合索引文件在 SET INDEX 或 USE 的 INDEX 子句中的指定顺序返回。

nWorkArea | cTableAlias

从其他工作区中打开的文件中返回标识名或索引文件名。
nWorkArea 指定工作区号，cTableAlias 指定表别名。默认情况下，返回当前工作区中文件的标识名和索引文件名。

返回值类型

字符型

说明

标识是多项复合索引 .CDX 文件的索引项。可以用 INDEX 语句创建多项复合索引 .CDX 文件。

附注
用 SET INDEX 或 USE 语句中的 INDEX 子句，可以为一个表打开多项复合索引文件 (.CDX) 和单项索引文件 (.IDX)。结构复合索引文件随表的打开而自动打开。