Poster of Linux kernelThe best gift for a Linux geek
firestring_set_error_handler

firestring_set_error_handler

Section: C Library Functions (3) Updated: 2003-07-21
Local index Up
 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:46:13 GMT, April 16, 2011