mbkrealloc

Langue: en

Version: October 1, 1997 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

mbkrealloc - mbk memory reallocator
man2html: unable to open or read file man1/alc_origin.1

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).
man2html: unable to open or read file man1/alc_bug_report.1