Retrieving info about a data dictionaryΒΆ
OpenDotd() |
Retrieve basic info about a data dictionary (.d) file |
SYNTAX
OpenDotd(pathname, nfields, nkeys, nindexes [, version] [, propvalues])
Retrieve information about a data dictionary file.
pathname |
The path of the data dictionary (.d) file to be read. |
||||||||||
nfields |
The number of fields in the file is returned in this field. |
||||||||||
nkeys |
The number of key fields in the main index of the file is returned in this field. |
||||||||||
nindexes |
The number of secondary indexes defined for the file is returned in this field. |
||||||||||
version |
The data dictionary version number. May be omitted if propvalues is not supplied. |
||||||||||
propvalues |
Alphanumeric array of 5 elements. If supplied, the array is filled with the following values:
|
nfields, nkeys, nindexes and version should be either unsigned (u) or integer (i) type fields.
The function returns 0 if the file was successfully read, otherwise -1. Possible reasons for failure include permissions, file does not exist, and bad file format.
NOTES
The FieldProp() function returns information about a specific field in a data dictionary. OpenIndex() returns general information about a specified secondary index, and IndexFieldProp() returns properties of a specified field in a secondary index.
RELATED TOPICS |