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