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)