__DBCOPYSTRUCT()
Create a new database based on current database structure
- Syntax
- __dbCopyStruct( <cFileName>, [<aFieldList>] ) --> NIL
- Arguments
- <cFileName> is the name of the new database file to create. (.dbf) is the default extension if none is given.
- <aFieldList> is an array where each element is a field name. Names could be specified as uppercase or lowercase.
- Returns
- __dbCopyStruct() always return NIL.
- Description
- __dbCopyStruct() create a new empty database file with a structure that is based on the currently open database in this work-area. If is empty, the newly created file would have the same structure as the currently open database. Else, the new file would contain only fields that exactly match .
- __dbCopyStruct() can be use to create a sub-set of the currently open database, based on a given field list.
- COPY STRUCTURE command is preprocessed into __dbCopyStruct() function during compile time.
- Examples
- // Create a new file that contain the same structure
- USE TEST
- __dbCopyStruct( "MyCopy.DBF" )
- // Create a new file that contain part of the original structure
- LOCAL aList
- USE TEST
- aList := { "NAME" }
- __dbCopyStruct( "OnlyName.DBF", aList )
- Status
Ready
- Compliance
- __dbCopyStruct() works exactly like CA-Clipper's __dbCopyStruct()
- Platforms
- All
- Files
- Library is rdd
- See Also