c/error/set constraint handler s

Configures the handler to be called by all bounds-checked functions on a runtime constraint violation or restores the default handler (if is a null pointer)

The handler must be a pointer to function of type, which is defined as

On a runtime constraint violation, it is called with the following arguments: @1@ pointer to character string that describes the error @2@ pointer to an implementation-defined object or a null pointer. Examples of implementation-defined objects are objects that give the name of the function that detected the violation and the line number when the violation was detected @3@ the error about to be returned by the calling function, if it happens to be one of the functions that return

If is never called, the default handler is implementation-defined: it may be abort_handler_s, ignore_handler_s, or some other implementation-defined handler.


 * As with all bounds-checked functions, and  are only guaranteed to be available if  is defined by the implementation and if the user defines  to the integer constant  before including.

Return value
A pointer to the previously-installed runtime constraints handler. (note: this pointer is never a null pointer because calling sets up the system default handler)