company logo

DBExtend :: GetBaseExtent - Get super set definition

The function provides the property definition for a super set (base extent).

The function works for property definitions referring to extents. When calling the function for structure properties or key components, no property definition is returned.

In order to provide the super set for a local property (relationship) the Property function baseCollection() can be called.

When the function is called with an invalid property definition it, throws an exception.

Return value:  Internal extent definition ( DBExtend * )

Implementation overview

Implementation details

  1. Get base extent by position
    DBExtend * DBExtend  :: GetBaseExtent ( int16 extent_pos )

    This implementation searches for the extent in the extent list at the position in the list. This function can be used to list all base extents for an extent. The function returns NULL, when no (more) extents could be found at the given position.

    • extent_pos - Extent position in the list

      This is the relative position of an extent in a list. The first extent in the list has position 0.

  2. to list
  3. Get base extent by name
    DBExtend * DBExtend  :: GetBaseExtent ( NString &cnstring )

    This implementation searches for the extent in the extent list with the name passed to the function. The function returns NULL, when no extent with the given name has been found in the list of base extents.

    • cnstring - String containing the text
  4. to list