Function DbeBuild() Foundation
Assembles and loads a compound database engine (DBE) from loaded component DBEs.
DbeBuild( <cCompoundDBE> , ; <cDataDBE> , ; [<cOrderDBE>] , ; [<cRelationDBE>] , ; [<cDictionaryDBE>] ) --> lSuccess
When a compound DBE was generated from the specified component DBEs, the function returns the value .T. (true). Otherwise, it returns .F. (false).
The DBE function DbeBuild() generates a new, assembled database engine (compound DBE) from previously loaded DBEs (component DBEs). A compound DBE makes use of all the characteristics of the component DBEs. When DbeBuild() is successful, it also means that DbeSetDefault() has been called with the new DBE, meaning the newly formed DBE is the default used for file management. This is then used as the default for commands like USE (where the option VIA can be specified) and all functions which can optionally specify a database engine.
In Xbase++ database engines can be assembled from up to four different components to build a database model. These individual components are the DATA, ORDER, RELATION and DICTIONARY components. A component is represented by a database engine (component DBE) which is contained in a DLL file and must be loaded into main memory using the function DbeLoad() before calling the function DbeBuild(). The function DbeBuild() creates a compound DBE from the specified component DBEs.
The number of component DBEs required for the definition of a database model varies depending on the database model. For the Xbase database model as defined by Clipper, the DATA component (DBFDBE) and the ORDER component (NTXDBE) are sufficient. (See the chapter "The Xbase++ Database Engine" in the Xbase++ documentation).
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.