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)
2003-07-21 firestring_set_error_handler(3)