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:

1

The file title

2

File comment, line 1

3

File comment, line 2

4

File comment, line 3

5

File comment, line 4

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

FieldProp()

OpenIndex()

IndexFieldProp()

Data dictionaries

Field types and sizes