<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/malloc.c">
<Name>emalloc</Name>
<Class>Utilities/Memory
<Purpose>
<P>Allocates the given number of bytes of memory and returns a pointer
to it, using the system-supplied malloc function.
<P>If there is not enough memory, a fatal error is generated.
The What argument is included in any such error message, and should
be a human-readable description of the error, as an aid to help the
user understand exactly what failed.</P>
<P>A future release of lq-text will have an improved memory allocation
interface.</P>
<Errors>
A fatal (E_FATAL | E_MEMORY) error is produced if memory is
exhausted.
<SeeAlso>
ecalloc
efree
Error
</Function>
<Decl>
char *
emalloc(What, nbytes)
    CONST char *What;
    unsigned nbytes;
</Decl>
</Entry>
