Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MBKREALLOC(3)		     MBK UTILITY FUNCTIONS		 MBKREALLOC(3)

NAME
       mbkrealloc - 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 us-
			   ing mbkallocP

       bytes		   Number of memory bytes to be	contiguously allocated

DESCRIPTION
       mbkrealloc  returns  a  block of	bytes length, for any purpose.	It in-
       creases 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  re-
	      trieved 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).

ASIM/LIP6			October	1, 1997			 MBKREALLOC(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mbkrealloc&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help