K E Y 函数

K E Y 函数 - 图3 返回索引标识或索引文件的索引关键字表达式

语法

KEY([ CDXFileNam e,] nIndexNumber [, nWorkArea | cTableAlias ])

返值类型

字符型

参数描述

CDXFileName

K E Y 函数 - 图4 K E Y 函数 - 图5 K E Y 函数 - 图6 K E Y 函数 - 图7 K E Y 函数 - 图8 K E Y 函数 - 图9 指定复合索引文件的文件名 KEY 函数将返回 .CDX 文件中索引标识的索引关键字表达式所指定的复合索引文件可以是和表一起自动打开的结构复合索引文件也可以是独立的复合索引文件

nIndexNumber

K E Y 函数 - 图10 指定要返回哪一个索引关键字表达式

K E Y 函数 - 图11 K E Y 函数 - 图12 K E Y 函数 - 图13 K E Y 函数 - 图14 USE 和 SET INDEX 命令都支持一个索引文件列表从中可以为一个表同时打开多个索引文件索引文件列表中可以包含 .IDX 单项索引文件结构复合索引文件或独立的复合索引文件等三种索引文件的任意组合

K E Y 函数 - 图15 数值表达式 nIndexNumber 指定从打开的索引文件中返回哪一个索引表达式随着

K E Y 函数 - 图16 nIndexNumber 从 1 递增到所打开的 .IDX 单项索引文件结构复合索引文件和独立复合

K E Y 函数 - 图17 K E Y 函数 - 图18 K E Y 函数 - 图19 K E Y 函数 - 图20 索引文件三者的总数 KEY 函数将按下列顺序依次从打开的各索引文件中返回索引表达式

首
先返回 .IDX 单项索引文件如果有此类文件打开中的索引表达式

K E Y 函数 - 图24 各个单项索引文件在 USE 或 SET INDEX 命令中的排列顺序决定索引表达式的返回顺序

其

次返回结构复合索引如果有中的每个标识的索引表达式多个标识的索引表达式的返回顺序取决于各标识在结构复合索引中的创建顺序
最

后返回打开的独立复合索引中的每个标识的索引表达式多个标识的索引表达式的返回顺序取决于标识在独立复合索引中创建的顺序

K E Y 函数 - 图31 K E Y 函数 - 图32 K E Y 函数 - 图33 K E Y 函数 - 图34 若 nIndexNumber 大于打开的索引文件总数包括 .IDX 单项索引文件结构复合索引文件和独立的复合索引文件 K E Y 函数 - 图35 则返回空字符串

n W o rkArea

K E Y 函数 - 图36 K E Y 函数 - 图37 K E Y 函数 - 图38 K E Y 函数 - 图39 指定表所在的工作区号 KEY 函数将返回该表的索引关键字表达式

K E Y 函数 - 图40 K E Y 函数 - 图41 K E Y 函数 - 图42 K E Y 函数 - 图43 如果指定的工作区中没有表打开则 KEY 函数返回空字符串

cTableAlias

K E Y 函数 - 图44 K E Y 函数 - 图45 K E Y 函数 - 图46 指定表别名 KEY K E Y 函数 - 图47 函数将返回该表的索引关键字表达式

K E Y 函数 - 图48 K E Y 函数 - 图49 若指定的表别名不存在 Visual FoxPro 将产生错误信息

K E Y 函数 - 图50 K E Y 函数 - 图51 若省略 nWorkArea 和 cTableAlias 参数将返回当前工作区中打开表的索引关键字表达式

说明

K E Y 函数 - 图52 K E Y 函数 - 图53 用 INDEX 命令创建索引标识或索引文件时可指定其索引关键字表达式当该索引标识或索引文件作为主控索引标识或主控索引文件打开时其索引关键字表达式将决定

K E Y 函数 - 图54 表的显示或访问方式

K E Y 函数 - 图55 K E Y 函数 - 图56 K E Y 函数 - 图57 有关创建索引标识索引文件以及索引关键字表达式的详细内容请参阅 INDEX

示例

K E Y 函数 - 图58 K E Y 函数 - 图59 K E Y 函数 - 图60 K E Y 函数 - 图61 K E Y 函数 - 图62 下面的示例先打开 testdata 数据库中的 customer 表然后在 FOR ... ENDFOR 创建的循环中使用 KEY 函数来显示 customer 结构索引文件中每个索引标识的索引表达式每个结构索引标识名和它的索引表达式同时显示

CLOSE DATABASES

OPEN DATABASE (HOME(2) + 'Data\testdata') USE Customer && 打开 customer 表CLEAR

FOR nCount = 1 TO 254

IF !EMPTY(TAG(nCount)) && 检查索引文件中的标识

? TAG(nCount) + ' ' && 显示标识的名称

?? KEY ( nCount) && 显示索引表达式

ELSE

EXIT && 所有标识都搜索完以后退出循环

ENDIF ENDFOR

请参阅

INDEX , REINDEX , SET INDEX , SYS(14)

K E Y 函 数

K E Y 函 数

K E Y 函数

K E Y 函数