mbkrealloc.3alc - Man Page
mbk memory reallocator
Synopsis
#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).