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).

Info

October 1, 1997 ASIM/LIP6 MBK UTILITY FUNCTIONS