operator delete[] (<new>)
The function called by a delete expression to deallocate storage for an array of objects.
void operator delete[](
void* _Ptr
) throw( );
void operator delete[](
void *,
void *
) throw( );
void operator delete[](
void* _Ptr,
const std::nothrow_t&
) throw( );
Parameters
- _Ptr
The pointer whose value is to be rendered invalid by the deletion.
Remarks
The first function is called by an delete[] expression to render the value of _Ptr invalid. The function is replaceable because the program can define a function with this function signature that replaces the default version defined by the Standard C++ Library. The required behavior is to accept a value of _Ptr that is null or that was returned by an earlier call to operator new[](size_t). The default behavior for a null value of _Ptr is to do nothing. Any other value of _Ptr must be a value returned earlier by a call as previously described. The default behavior for such a nonnull value of _Ptr is to reclaim storage allocated by the earlier call. It is unspecified under what conditions part or all of such reclaimed storage is allocated by a subsequent call to operator new(size_t), or to any of calloc(size_t), malloc(size_t), or realloc(void*, size_t).
The second function is called by a placement delete[] expression corresponding to a new[] expression of the form new[](std::size_t). It does nothing.
The third function is called by a placement delete expression corresponding to a new[] expression of the form new[](std::size_t, const std::nothrow_t&). The program can define a function with this function signature that replaces the default version defined by the Standard C++ Library. The required behavior is to accept a value of _Ptr that is null or that was returned by an earlier call to operator new[](size_t). The default behavior is to evaluate delete[](_Ptr).
Example
See operator new[] for examples of the use of operator delete[].
Requirements
Header: <new>
Namespace: std