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)