Functions.IdxCollate 方法 | |
返回索引或索引标识的排序序列。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION IdxCollate(
uIndex,
nIndex,
uArea
) AS STRING CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static string IdxCollate(
__Usual uIndex = default,
__Usual nIndex = default,
__Usual uArea = default
)
查看代码参数
- uIndex (Optional)
- 类型:__Usual
指定复合索引文件的名称。您指定的复合索引文件可以是与表自动打开的结构性复合索引文件,也可以是独立的复合索引文件。
- nIndex (Optional)
- 类型:__Usual
指定 IDXCOLLATE( ) 返回排序序列的索引或索引标识。
IDXCOLLATE( ) 按照 nIndexNumber 从 1 增加到打开的索引文件和索引标识的总数的顺序返回索引和索引标识的排序序列:
首先返回单项 .idx 索引文件(如果有打开的)。
单项索引文件在 Use 或 Set Index 中包含的顺序决定了返回排序序列的顺序。
接下来返回结构性复合索引(如果存在)中的标识的排序序列。按照在结构性复合索引中创建标识的顺序返回排序序列。
最后返回任何打开的独立复合索引中的标识的排序序列。按照在独立复合索引中创建标识的顺序返回排序序列。 如果 nIndexNumber 大于打开的索引文件总数,则返回空字符串。
- uArea (Optional)
- 类型:__Usual
指定要返回其锁定状态的表的工作区号。如果省略 cTableAlias 和 nWorkArea,则返回当前工作区中打开的表的排序序列。
或
指定要返回其锁定状态的表的别名。如果指定的别名不是打开的表,则会生成“别名未找到”错误消息。
返回值
类型:
String
字符型
备注 IDXCOLLATE( ) 可用于返回多项复合索引文件中每个标识的排序序列,
允许您完全删除索引文件并使用一系列 Set COLLATE 和 Index 命令正确重建它。
请注意,IDXCOLLATE( ) 对于 REIndex 的正常运行不是必需的,因为现有索引和索引标识中存在排序序列信息。
有关 X# 国际支持的更多信息,请参阅开发国际应用程序。
示例 1Close Databases
2Open Database (HOME(2) + 'Data\testdata')
3Use Customer
4Clear
5
6For nCount = 1 TO TAGCOUNT( )
7 IF !EMPTY(TAG(nCount))
8 ? TAG(nCount) + ' '
9 ?? IDXCOLLATE(nCount)
10 ELSE
11 EXIT
12 ENDIF
13ENDFor
参见