company logo

DBObjectHandle :: DeleteExtent - Delete extent

The function deletes an extent. This is not done automatically when the extent has no instances anymore.

The extent will be removed completely, which includes removing all instances from derived extents. When the extent owns the instances, also the instances will be deleted, which may take some time.

Extents should be removed, before being deleted in the dictionary. When the extent definition is not available anymore, the extent will be deleted without deleting owned instances. This may cause database error, which can be repaired calling CheckDB().

Return value:  Success ( logical  )

Implementation details

  1. - internal feature
    logical DBObjectHandle  :: DeleteExtent ( NString &extnames, int32 nsid )
    • extnames - Extent name

      The name contains the name of the extent, only. It does not contain a namespace scope.

      Notes:

      retval checked for const &NString

    • nsid - - internal feature
  2. to list
  3. - internal feature
    logical DBObjectHandle  :: DeleteExtent ( NString &scope_name, NString &extnames )
    • scope_name - Name of a Scope

      Defines the name of a scope (in some cases the name of a namespace)

      eg

      'std::algorithm'

      'std' (::string)

    • extnames - Extent name

      The name contains the name of the extent, only. It does not contain a namespace scope.

      Notes:

      retval checked for const &NString

  4. to list
  5. - internal feature
    logical DBObjectHandle  :: DeleteExtent ( NString &extnames )
    • extnames - Extent name

      The name contains the name of the extent, only. It does not contain a namespace scope.

      Notes:

      retval checked for const &NString

  6. to list
  7. - internal feature
    logical DBObjectHandle  :: DeleteExtent ( TypeKey &tkey )
    • tkey - - internal feature
  8. to list