17 Library introduction [library]

The C++ standard library provides default versions of the following handler functions (Clause [language.support]):

• (1.1)

  unexpected_handler

• (1.2)

  terminate_handler

A C++ program may install different handler functions during execution, by supplying a pointer to a function defined in the program or the library as an argument to (respectively):

• (2.1)

  set_new_handler

• (2.2)

  set_unexpected

• (2.3)

  set_terminate

  See also: subclauses [alloc.errors], Storage allocation errors, and [support.exception], Exception handling.

A C++ program can get a pointer to the current handler function by calling the following functions:

• (3.1)

  get_new_handler

• (3.2)

  get_unexpected

• (3.3)

  get_terminate

Calling the set_* and get_* functions shall not incur a data race. A call to any of the set_* functions shall synchronize with subsequent calls to the same set_* function and to the corresponding get_* function.