set_new_handler (3C++std) - Tru64 UNIX
Standard C++ Library
NAME
new_handler, set_new_handler - new_handler is the type of a function called
by operator new() or operator new []() when a request for storage can not
be met. set_new_handler() is a function which sets the current
new_handler.
SYNOPSIS
#include <new>
namespace std {
typedef void (*new_handler)();
new_handler set_new_handler(new_handler new_h) throw();
}
DESCRIPTION
set_new_handler() sets the current new_handler to the the function passed
in as its new_handler input parameter. It returns the previous
new_handler.
A function of type new_handler is required to do one of the following:
o make more storage available for allocation and return
o throw an exception of type bad_alloc or a class derived from
bad_alloc
o call abort() or exit()
The Standard C++ Library provides a default new_handler which throws an
exception of type bad_alloc. The implementation provided new_handler is
called by default.
SEE ALSO
new, bad_alloc
STANDARDS CONFORMANCE
ANSI X3J16/ISO WG21 Joint C++ Committee
privacy and legal statement