Functions.KeyMatch 方法 | |
-- todo --
在索引标记或索引文件中搜索索引键。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION KeyMatch(
eIndexKey,
nIndexNumber,
uArea
) AS LOGIC CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool KeyMatch(
__Usual eIndexKey = default,
__Usual nIndexNumber = default,
__Usual uArea = default
)
查看代码参数
- eIndexKey (Optional)
- 类型:__Usual
指定KeyMatch()搜索的索引键。索引文件或索引标记中的索引键由索引表达式确定。
使用Index创建索引文件或索引标记时指定索引表达式。
可以使用KEY()和SYS(14)返回索引文件和索引标记的索引表达式。
有关创建索引文件、索引表达式和索引键的更多信息,请参见Index。
如果不包含任何可选参数,KeyMatch()将在主索引文件或主索引标记中搜索您指定的索引键。
如果没有生效的主索引文件或索引标记(例如,您已发出不带任何参数的Set Order To以将表置于物理记录顺序),X#将生成错误消息。
- nIndexNumber (Optional)
- 类型:__Usual
指定搜索哪个索引文件或索引标记。
nIndexNumber通常是从1开始的整数,每增加1就搜索额外的索引标记。
如果nIndexNumber为1,则搜索主单条目.idx索引文件或主索引标记(如果存在)。
随着nIndexNumber增加,会搜索结构复合索引(如果存在)中的后续标记。
搜索标记的顺序与在结构复合索引中创建标记的顺序相同。
随着nIndexNumber继续增加并且结构复合索引中的所有标记都已搜索完毕,
然后搜索任何打开的独立复合索引中的标记。
搜索标记的顺序与在独立复合索引中创建标记的顺序相同。
如果nIndexNumber大于打开的单条目.idx文件以及结构复合和独立复合索引标记的总数,则会生成错误消息。
- uArea (Optional)
- 类型:__Usual
搜索在另一个工作区中打开的索引文件或标记。
uArea指定工作区编号或表别名。
如果省略工作区和别名,KeyMatch()将搜索当前工作区中表的打开索引文件或标记。
如果没有表具有您指定的别名,X#将生成错误消息。
返回值
类型:
Boolean
逻辑值
备注
KeyMatch()在索引标记或索引文件中搜索特定的索引键,如果找到索引键则返回真(.T.);
否则,KeyMatch()返回假(.F.)。KeyMatch()可用于防止重复的索引键。
KeyMatch()将记录指针返回到发出KeyMatch()之前最初所在的记录位置。
参见