<new>

 

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

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>  
  

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

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

Typedefs

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

Functions

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

Operators

operator deleteThe 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 newThe 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 ClassThe class describes an exception thrown to indicate that an allocation request did not succeed.
nothrow_t ClassThe 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.

Header Files Reference
Thread Safety in the C++ Standard Library

Show: