company logo

DictionaryHandle :: CreateTempExtent - Create temporary extent

A temporary extent can be created for storing results of a query (e.g. a selection) within an application. Temporary extents are created in main storage or in a temporary database and are available as long as the database handle is opened. They will be removed automatically when closing the database handle.

When a temporary extent has been created once, one may open any number of property handles for accessing the extent.

One may define an extent for a structure definition defined in the external dictionary by referring to the structure name) or by an internal structure definition that has been created by the application and is referenced by the field definition passed to the function.

Return value:  String containing the text ( NString & )

Implementation details

const NString & DictionaryHandle  :: CreateTempExtent ( NString &strnames, NString &extnames_nc, NString &key_name_w=NString::Null(), NString &baseexts_w=NString::Null(), logical weak_opt_w=NO, logical own_opt_w=NO )
  • strnames - Type name
  • extnames_nc - - Title unknown
  • key_name_w - Key name for conversion Default: NString::Null()
  • baseexts_w - Name for base extent Default: NString::Null()
  • weak_opt_w - Weak-typed option

    This option must be true ( YES ) when a collection may refer to instances of different types, which are based on the same base structure.

    Default: NO
  • own_opt_w - Owning collection

    This option must be set to true ( YES ) if the collection owns the instances it is referring to. In this case the collection may not refer to instances from other collections. Removing instances from an owning collection will result in deleting the instance completely.

    Default: NO