NAME¶
firestring_set_error_handler - set the function to be called on an allocation
failure
SYNOPSIS¶
#include <firestring.h>
-lfirestring
void firestring_set_error_handler(void (*e)())
DESCRIPTION¶
firestring_set_error_handler() takes the name of a function that takes no
parameters and returns void. This function will be called whenever firestring
fails to allocate memory.
As memory allocation failures are fatal to most programs, firestring does not
return errors when functions fail to allocate memory; it simply calls this
function, which it expects to call
exit() or
abort() or in some
way terminate execution of the program. It probably is not safe to pass a
function that returns, unless you have a framework in place for passing the
allocation failure information back to the code calling the firestring
function.
The default function calls
perror() and then
exit().
RETURN VALUE¶
None
AUTHOR¶
Ian Gulliver <ian@penguinhosting.net>
SEE ALSO¶
libfirestring(3)