descending( ) 函数

示例 请参阅

返回一个逻辑值,该值表明是否用 DESCENDING 关键字创建了一个索引标识,或是否在 USE、SET INDEX 或 SET ORDER 中包含 DESCENDING 关键字。

语法

DESCENDING([CDXFileName,] nIndexNumber [, nWorkArea | cTableAlias])

参数

CDXFileName

可用 CDXFileName 指定一个复合索引文件名。所指定的复合索引文件可以是和表一起自动打开的结构复合索引文件,或者是一个独立复合索引文件。

nIndexNumber

数值型表达式 nIndexNumber 指定 DESCENDING( ) 测试的索引标识或索引文件。nIndexNumber 通常是一个从 1 开始且以 1 为单位递增的整数,代表了各个索引标识。
如果 nIndexNumber 为 1,就为 .IDX 主控单项索引文件或主控索引标识(如果存在)返回一个值。
随着 nIndexNumber 递增,可以为结构复合索引文件(如果存在)中的每个标识返回值。为标识返回的值按照它们在结构复合索引文件中创建的顺序返回。
为结构复合索引文件中的所有标识返回了值以后,再为所有打开的独立复合索引文件中的每个标识返回值。为标识返回的值按照它们在独立复合索引文件中创建的顺序返回。

如果 nIndexNumber 大于打开的单项索引 .IDX 文件和结构复合以及独立复合索引标识的总数,就返回空字符串。

nWorkArea | cTableAlias

为非当前工作区的索引文件或标识返回值。nWorkArea 指定工作区号,cTableAlias 指定表别名。
如果没有指定的表别名,Visual FoxPro 将产生错误信息。

返回值类型
逻辑型

说明
可以用两种方法对一个表中的记录进行降序排列:

DESCENDING( ) 可以确定一个索引标识是否以降序创建。如果所指定的索引标识是用 DESCENDING 关键字创建的,则 DESCENDING( ) 返回“真”(.T.)。
DESCENDING( ) 也可以确定主控索引标识或主控索引文件是否为降序。如果指定的主控索引标识或一个单项索引 (.IDX) 文件在 USE、SET INDEX,或 SET ORDER 中包含了 DESCENDING 关键字,DESCENDING( ) 就返回“真”(.T.)。
如果不包含任何可选的参数,DESCENDING( ) 就为主控索引标识或主控索引文件返回一个值。如果不包含任何可选的参数,且主控索引标识或 .IDX 文件无效(例如,执行了 SET ORDER TO 按物理记录顺序对表排序),DESCENDING( ) 返回“假”(.F.)。