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 overview

Implementation details

  1. - internal feature (not documented)
    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 (not documented)
  2. to list
  3. - internal feature (not documented)
    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 (not documented)
    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 (not documented)
    logical DBObjectHandle  :: DeleteExtent ( TypeKey &tkey )
    • tkey - - internal feature (not documented)
  8. to list