K E Y M A T C H 函 数
在索引标识或索引文件中搜索一个索引关键字
语 法
K E Y M A T C H ( eIndexKey [, nIndexNumber [, nWorkArea | cTableAlias ]])
返 值 类 型
逻辑值
参 数 描 述
eIndexKey
指 定 要 搜 索 的 索 引 关 键 字 索 引 文 件 或 索 引 标 识 中 的 索 引 关 键 字 是 由 索 引 表达 式 决 定 的 用 INDEX 命 令 创 建 索 引 文 件 或 索 引 标 识 时 可 以 指 定 其 索 引 表达 式 KEY 函 数 和 SYS(14) 命 令 都 可 返 回 索 引 文 件 或 索 引 标 识 的 索 引 表达 式 有 关 创 建 索 引 文 件 索 引 表 达 式 以 及 索 引 关 键 字 的 详 细 内 容 请 参 阅INDEX
若省略所有可选参数 KEYMATCH 函数将在主控索引文件或主控索引标识中搜索指定的索引关键字 如果不存在有效的主控索引文件或主控索引标识 例如 已用不包含任何参数的 SET ORDER TO 命令把表设置成了物理记录顺序 Visual FoxPro 将产生错误信息
nIndexNumber
指 定 在 哪 一 个 索 引 文 件 或 索 引 标 识 中 搜 索 通 常 情 况 下 若 要 搜 索 其 他 的 索引 标 识 nIndexNumber 一 般 是 一 个 从 1 开 始 以 1 递 增 的 整 数
如 nIndexNumber 为 1 则搜索主控单项索引 (.IDX) 文件或主控索引标识 如果有 随着 nIndexNumber 的增大 依次搜索结构复合索引文件 如果有 中各个后续标识各个标识的搜索次序取决于它们在结构复合索引中的创建顺序
随着 nIndexNumber 的继续增大 在搜索结构复合索引文件中的所有标识后 将搜索打开的独立复合索引文件中的标识 各标识的搜索次序取决于它们在独立复合索引中的创建顺序
若 nIndexNumber 大于打开的索引文件总数 包括 .IDX 单项索引文件 结构复合索引标识和独立的复合索引标识 Visual FoxPro 将产生错误信息
n W o rkArea | cTableAlias
用 于 搜 索 非 当 前 工 作 区 中 的 索 引 文 件 或 标 识 nWorkArea 指 定 工 作 区 号cTableAlias 指 定 表 别 名 若 省 略 这 两 个 参 数 KEYMATCH 函 数 将 搜 索由 当 前 工 作 区 中 的 表 打 开 的 索 引 文 件 或 标 识
如果指定的表别名不存在 Visual FoxPro 将产生错误信息
说 明
KEYMATCH 函数在索引标识或索引文件中搜索指定的索引关键字 若找到 则返回真 (.T.) 否则 返回 假 (.F.) 该函数可以用来防止重复出现的索引关键字
KEYMATCH 函数运行完之后 仍把记录指针放置到运行该函数之前记录指针所指的记录上
请 参 阅
INDEX , INDEXSEEK ( ) , KEY( ) , SET INDEX , SYS(14) , USE