<!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>erealloc</Name>
<Class>Utilities/Memory
<Purpose>
<P>Changes the size of the given Object, either by extending the
area of memory allocated to it or by allocating a new area,
copying the data and freeing the original storage area.</P>
<P>If insufficient memory is available, a fatal (E_FATAL) error
is produced, which includes the given What argument as a textual
(human-readable) description of the object.</P>
<P>The system-supplied realloc function is used.</P>
<Returns>
A pointer to the newly sized object; in most implementations this
will almost always be a new copy of the object.
<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 *
erealloc(Object, NewSize)
    char *Object;
    unsigned int NewSize;
</Decl>
</Entry>
