Standard C++ Library

NAME

  terminate_handler, set_terminate, terminate -  The type terminate_handler
  and functions set_terminate() and terminate() support abnormal program
  termination.

SYNOPSIS

  #include <exception>

  namespace std {
    typedef void (*terminate_handler)();
    terminate_handler set_terminate(terminate_handler new_h) throw();
    void terminate();
  }

DESCRIPTION

  typedef void (*terminate_handler)();

  terminate_handler is the type of handler function called by terminate()
  when terminating exception processing.  The required behavior of a
  terminate_handler is to terminate program expansion without returning to
  the caller.  The Standard C++ Library provides a terminate_handler which is
  called by default.  The library provided terminate_handler calls abort().

  terminate_handler set_terminate(terminate_handler new_h) throw();

  set_terminate() sets the current terminate_handler to the function passed
  in as its terminate_handler input parameter.  It returns the previous
  terminate_handler.  The function is not allowed to be a null pointer.

  void terminate();

  terminate() is called by the implementation when exception handling must be
  abandoned.  It may be directly called by a user program.  If called by the
  implementation, terminate() calls the terminate_handler function in effect
  after evaluating the throw-expression.  If called by the program,
  terminate() calls the current terminate_handler function.

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement