debian man page for firestring_set_error_handler

firestring_set_error_handler(3) 			     Library Functions Manual				   firestring_set_error_handler(3)

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 when-
       ever 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 sim-
       ply  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)