company logo

DBObjectHandle :: DeleteExtentRef - Delete extent reference

The function deletes the offset for the extent. After deleting an extent offset, the extent does practically not exist. Future requests for the extent will recreate an empty extent.

When the extent has sub extents, those are deleted as well.

The use of the function is critical, since instances owned by the extent are not maintained and may cause problems later on.

Return value:  Success ( logical  )

Implementation overview

Implementation details

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