Share via

<new>

  • Article

Defines several types and functions that control the allocation and freeing of storage under program control. It also defines components for reporting on storage management errors.

#include <new>

Remarks

Some of the functions declared in this header are replaceable. The implementation supplies a default version, whose behavior is described in this document. A program can, however, define a function with the same signature to replace the default version at link time. The replacement version must satisfy the requirements described in this document.

Objects

nothrow

Provides an object to be used as an argument for the nothrow versions of new and delete.

Typedefs

new_handler

A type that points to a function suitable for use as a new handler.

Functions

set_new_handler

Installs a user function that is called when new fails in its attempt to allocate memory.

Operators

operator delete

The function called by a delete expression to deallocate storage for individual of objects.

operator delete[]

The function called by a delete expression to deallocate storage for an array of objects.

operator new

The function called by a new expression to allocate storage for individual objects.

operator new[]

The function called by a new expression to allocate storage for an array of objects.

Classes

bad_alloc Class

The class describes an exception thrown to indicate that an allocation request did not succeed.

nothrow_t Class

The class is used as a function parameter to operator new to indicate that the function should return a null pointer to report an allocation failure, rather than throw an exception.

See Also

Reference

Thread Safety in the Standard C++ Library

Other Resources

<new> Members

Header Files