5.4.4 Initialising and registering error handlers with functions

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

Function: void cce_init_and_register_error_handler_4 (cce_destination_t L, cce_error_handler_t * H, cce_error_handler_fun_t * HANDLER_FUNCTION, void * RESOURCE_POINTER)

Initialise the error handler referenced by H with the given handler function and resource pointer; the argument RESOURCE_POINTER can be NULL. Register the error handler referenced by H in the list of handlers associated to the location L.

Upon exiting the associated location context: the handler might finalise the resource referenced by RESOURCE_POINTER, but it can also perform some unrelated operations.

Function: void cce_init_and_register_error_handler_5 (cce_destination_t L, cce_error_handler_t * H, cce_error_handler_fun_t * HANDLER_FUNCTION, void * RESOURCE_POINTER, cce_resource_destructor_fun_t * RESOURCE_DESTRUCTOR)

Initialise the error handler referenced by H with the given handler function, resource pointer and resource destructor; the arguments RESOURCE_POINTER and RESOURCE_DESTRUCTOR can be NULL. Register the error handler referenced by H in the list of handlers associated to the location L.

Upon exiting the associated location context: the handler might finalise the resource referenced by RESOURCE_POINTER using the destructor function referenced by RESOURCE_DESTRUCTOR, but it can also perform some unrelated operations.

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