##### Synopsis

    typedef void (*new_handler)();

    new_handler set_new_handler(new_handler) throw();

##### Description

set_new_handler establishes a new_handler function.

set_new_handler establishes a new_handler function that is called when operator new fails to allocate the requested memory. If the new_handler function returns then operator new will attempt to allocate the memory again. The new_handler function can throw an exception to implement standard C++ behaviour for memory allocation failure.

##### Portability

Standard C++.