table.RELATION_TAG Function

Syntax

Handle as N = Relation_Tag(C expression[,C Filter[,C Flags]])

Arguments

expression: A character order expression that sorts selected records.
Filter: A character filter expression that selects records in the table.
Flags: Optional. Default = "" (Ascending, not unique). A string of character flags that can specify a descending sort order ('D'), and or include only records with unique key values ('U').

Description

Builds and Returns an index handle for the relation_change and relation_add commands.

Discussion

The <TBL>.RELATION_TAG() method builds an index tag in the production index file for the table, and returns a handle for the index. It is used in conjunction with the <TBL>.RELATION_ADD() and <TBL>.RELATION_CHANGE() methods.

Example

dim tbl as P
tbl = table.open("customer")
? tbl.relation_tag("left(lastname,1) + left(firstname,1)")
= 83951618.000000