Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <stdlib.h>  For ANSI compatibility (malloc only)
    #include <malloc.h>  Required for other function prototypes
    void *malloc( size_t size );
    void __based(void) *_bmalloc( __segment seg, size_t size );
    void __far  *_fmalloc( size_t size );
    void __near *_nmalloc( size_t size );

Description:
    The  malloc functions allocate space for an object of size bytes.
     Nothing is allocated when the size argument has a value of zero.

    Each function allocates memory from a particular heap, as listed below:

    malloc
        Depends on data model of the program

    _bmalloc
        Based heap specified by seg value

    _fmalloc
        Far heap (outside the default data segment)

    _nmalloc
        Near heap (inside the default data segment)

    In a small data memory model, the  malloc function is equivalent to the
     _nmalloc function; in a large data memory model, the  malloc function
    is equivalent to the  _fmalloc function.

Returns:
    The  malloc functions return a pointer to the start of the allocated
    memory.  The  malloc,  _fmalloc and  _nmalloc functions return NULL if
    there is insufficient memory available or if the requested size is zero.
     The  _bmalloc function returns  _NULLOFF if there is insufficient
    memory available or if the requested size is zero.

See Also:
    calloc Functions Functions, _expand Functions Functions, free Functions Functions, halloc, hfree,
    _msize Functions Functions, realloc Functions Functions, sbrk

Example:
    #include <stdlib.h>

    void main()
      {
        char *buffer;

        buffer = (char *)malloc( 80 );
        if( buffer != NULL ) {

            /* body of program */

            free( buffer );
        }
      }

Classification:
    malloc is ANSI; _bmalloc, _fmalloc, _nmalloc are not ANSI

Systems:
     malloc - All

    _bmalloc - DOS/16, Win/16, QNX/16, OS/2 1.x(all)
    _fmalloc - DOS/16, Win/16, QNX/16, OS/2 1.x(all)
    _nmalloc - DOS, Win, QNX, OS/2 1.x, OS/2 1.x(MT), OS/2 2.x, NT