<!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>ecalloc</Name>
<Class>Utilities/Memory
<Purpose>
<P>Allocates sufficient memory to hold the given Number of objects
of the given Size, after taking alignment constraints into account;
the system-supplied calloc function is used.</P>
<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>
emalloc
efree
Error
</Function>
<Decl>
char *
ecalloc(What, Number, Size)
    CONST char *What;
    unsigned int Number;
    unsigned int Size;
</Decl>
</Entry>
