5.3.1 Registering location handlers

All the following definitions are accessible from the header file ccexceptions.h.

Function: void cce_register_clean_handler (cce_destination_t L, cce_clean_handler_t * H)

Register the clean handler referenced by H in the list of handlers associated to the location L. A clean handler is meant to be called whenever the execution flow leaves the dynamic extent of a location, whether with an exception or as part of the successful execution path.

Function: void cce_register_error_handler (cce_destination_t L, cce_error_handler_t * H)

Register the error handler referenced by H in the list of handlers associated to the location L. An error handler is meant to be called whenever the execution flow leaves the dynamic extent of a location in case of an exceptional condition; it must not be called as part of the successful execution path.

Preprocessor Macro: void cce_register_handler (cce_destination_t L, cce_clean_handler_t * H)

Preprocessor Macro: void cce_register_handler (cce_destination_t L, cce_error_handler_t * H)

Generic macro using _Generic to dispatch its expansion depending on the type of the argument H. If the type of structure referenced by H is:

cce_clean_handler_t

The macro expands into a call to cce_register_clean_handler().

cce_error_handler_t

The macro expands into a call to cce_register_error_handler().

This document describes version 0.9.0-devel.3 of CCExceptions.