operator delete[]

• Global: All three versions of operator delete[] are declared in the global namespace, not within the std namespace.
• Implicit: The deallocating versions (i.e., all but (3)) are implicitly declared in every translation unit of a C++ program, no matter whether header <new> is included or not.
• Replaceable: The deallocating versions (i.e., all but (3)) are also replaceable: A program may provide its own definition that replaces the one provided by default to produce the result described above, or can overload it for specific types.

Parameters

ptr

A pointer to the memory block to be released, type-casted to a void*.
If this is a null-pointer, the function does nothing.

Otherwise, this pointer value should have been returned by a previous call to operator new[], and have not yet been released by a previous call to this function.

Otherwise, this pointer value should have been returned by a previous call to operator new[], and have not yet been released by a previous call to this function.
If the implementation has strict pointer safety, this pointer shall also be a safely-derived pointer.

nothrow_constant

The constant nothrow. This parameter is ignored in the default definition.
nothrow_t is the type of constant nothrow.

voidptr2

A void pointer. The value is ignored in the default definition.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// operator delete[] example
#include <iostream>     // std::cout
struct MyClass {
  MyClass() {std::cout <<"MyClass constructed\n";}
  ~MyClass() {std::cout <<"MyClass destroyed\n";}
};
int main () {
  MyClass * pt;
  pt = new MyClass[3];
  delete[] pt;
  return 0;
}

myclass constructed
myclass constructed
myclass constructed
myclass destroyed
myclass destroyed
myclass destroyed

Data races

Exception safety

See also

operator new[]

Allocate storage space for array (function)

operator delete

Deallocate storage space (function)