mbkalloc(3)

NAME

mbkalloc - mbk memory allocator

SYNOPSYS

#include "mut.h"
char ∗mbkalloc(bytes)
unsigned int bytes;

PARAMETER

bytes: Number of memory bytes to be contiguously allocated

DESCRIPTION

mbkalloc returns a block of bytes length, for any purpose. It is now a day just an encapsulation of the system malloc function, but may evolve to a special allocator in the future. Its use is strongly encouraged.

Remark :: a global variable, long mbkalloc_stat, updates the number of allocated bytes, and may be accessed by anyone to see the amount of allocated memory.

RETURN VALUE

mbkalloc returns a pointer to a bytes long block.

ERROR

"∗∗∗ mbk error ∗∗∗ mbkalloc 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 ∗dup_str(s);
{
char ∗t = (char ∗)mbkalloc(strlen(s) + (unsigned int)1);
	strcpy(t, s);
	return t;
}