Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
firestring_set_error_handleLibrary Functions Mafirestring_set_error_handler(3)

NAME
       firestring_set_error_handler  - set the function	to be called on	an al-
       location	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 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=firestring_set_error_handler&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help