KeyMatch Function

 FUNCTION KeyMatch(
	eIndexKey,
	nIndexNumber,
	uArea
) AS LOGIC CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool KeyMatch(
	Usual eIndexKey = default,
	Usual nIndexNumber = default,
	Usual uArea = default
)

Parameters

eIndexKey (Optional)

Type: Usual
Specifies the index key that KeyMatch( ) searches for. The index keys in an index file or index tag are determined by the index expression. An index expression is specified when an index file or index tag is created with Index. KEY( ) and SYS(14) can be used to return the index expressions for index files and index tags. For more information on creating index files, index expressions, and index keys, see Index.
If you don't include any of the optional parameters, KeyMatch( ) searches the master index file or master index tag for the index key you specify. If a master index file or index tag isn't in effect (for example, you've issued Set Order To without any parameters to place the table in physical record order), X# generates an error message.

nIndexNumber (Optional)

Type: Usual
Specifies which index file or index tag is searched. nIndexNumber is typically an integer that starts at 1 and is increased by 1 to search additional index tags.
If nIndexNumber is 1, the master single-entry .idx index file or master index tag (if one is present) is searched.
As nIndexNumber increases, subsequent tags in the structural compound index (if one is present) are searched. The tags are searched in the order in which the tags were created in the structural compound index.
As nIndexNumber continues to increase and all the tags in the structural compound index have been searched, tags in any open independent compound indexes are then searched. The tags are searched in the order in which the tags were created in the independent compound indexes.
An error message is generated if nIndexNumber is greater than the total number of open single-entry .idx files and structural compound and independent compound index tags.

uArea (Optional)

Type: Usual
Searches index files or tags open in another work area. uArea specefies the work area number or the table alias. If you omit the work area and alias, KeyMatch( ) searches index files or tags open for the table in the current work area.
If no table has the alias you specify, X# generates an error message.

Return Value

Reference