NAME

       firestring_malloc - malloc(3) with internal result checking

SYNOPSIS

       #include <firestring.h>
       -lfirestring

       void *firestring_malloc(const size_t size)

DESCRIPTION

       firestring_malloc()  acts  exactly  like malloc(3) except that it detects malloc failures,
       prints an error and exit(3) with exit  status  EXIT_FAILURE.   In  most  programs,  malloc
       failures are unrecoverable, and this is the preferred behaviour.

RETURN VALUE

       If  firestring_malloc()  returns,  it  always  returns a new memory area of size bytes. It
       never returns NULL.

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

SEE ALSO

       libfirestring(3)

                                            2002-03-31                       firestring_malloc(3)