MBKREALLOC(3) MBK UTILITY FUNCTIONS MBKREALLOC(3)
NAME
mbkrealloc - mbk memory reallocator
ORIGIN
This software belongs to the ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
Paris, France.
Web : http://asim.lip6.fr/recherche/alliance/
E-mail : alliance-users@asim.lip6.fr
SYNOPSYS
#include "mut.h"
void *mbkrealloc(pt, bytes)
void *pt;
unsigned int bytes;
PARAMETERS
pt Pointer to an already allocated area, allocated using mbkallocP
bytes Number of memory bytes to be contiguously allocated
DESCRIPTION
mbkrealloc returns a block of bytes length, for any purpose. It increases or decreases the size of the area, and return a pointer to the
new block. It is now a day only an encapsulation of the system realloc function, but may evolve to a special allocator in the future. Its
use is strongly encouraged.
Remark : a global variable, long mbkrealloc_stat, updates the number of allocated bytes, and may be accessed by anyone to see
the amount of allocated memory.
RETURN VALUE
mbkrealloc returns a pointer to a bytes long block.
ERROR
"*** mbk error *** mbkrealloc impossible : not enough memory"
System break can't be moved anymore, no more memory can be retrieved from the system.
EXAMPLE
#include "mut.h"
char *concatstring(t, s);
{
t = (char *)mbkrealloc(strlen(t) + strlen(s) + 1);
strcat(t, s);
return t;
}
SEE ALSO
mbk(1), mbkalloc(3), mbkfree(3).
BUG REPORT
This tool is under development at the ASIM department of the LIP6 laboratory.
We need your feedback to improve documentation and tools.
ASIM
/LIP6 October 1, 1997 MBKREALLOC(3)
