company logo

ObjectSpace :: extentName - Provide extent form Database Object

The function returns the name of the extent at position passed in iPosition from the extent list (created extents) of the object space. The collection of created extents does not necessarily include all defined extents. Extent names are provided in alphabetic order. The first extent is at position 0.

When no extent is available at position iPosition, the function throws an exception. In order to avoid an exception, the extent count (extentCount()) may be checked.

// fragment: ObjectSpace os;

  int    count = os.extentCount();

  int    i     = 0;

  while ( i < count )

    Output(os.extentName(i++) + "\n");

Return value:  Extent name ( odaba::String & )

Implementation details

odaba::String ObjectSpace  :: extentName ( int32 iPosition )
  • iPosition - Position in collection

    The position of an element in a collection is beginning with 0 for the first element.