Function DbCopyExtStruct() Foundation
Copies the field structure from a work area into a structure extended file.
DbCopyExtStruct( <cFilename> ) --> lSuccess
The function DbCopyExtStruct() returns the value .T. (true) when the structure extended file <cFilename> could be created, otherwise it returns .F. (false).
The database function DbCopyExtStruct() copies the field definitions from a work area into a file. This file is called a "structure extended" file since it contains the structure description of a separate file. It uses the same file format (is managed by the same Data Base Engine) as the file whose field structure it describes.
A structure extended file has at least four fields with each record containing information about a field of another file. The predefined fields of a structure extended file are listed in the following table:
Field name | Field type | Field length | Decimal places |
---|---|---|---|
FIELD_NAME | Character | 10 | 0 |
FIELD_TYPE | Character | 1 | 0 |
FIELD_LEN | Numeric | 5 | 0 |
FIELD_DEC | Numeric | 4 | 0 |
The function DbCreateExtStruct() resembles the function DbStruct() which returns the field specifications in a two dimensional array. DbCreateExtStruct() writes this information into a file instead of an array. The function is also used define or change the file or field structure of database files at runtime of an Xbase++ application. A new file can be created from this information using the function DbCreateFrom().
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.