alloc.h File Reference

C-style dynamic memory allocation interface. More...

#include "types.h"

Include dependency graph for alloc.h:

This graph shows which files directly or indirectly include this file:

Functions
void *	malloc (size_t size)
	Allocate a memory block The memory is not initialized. More...
void	free (void *ptr)
	Free an allocated memory block. More...
void *	realloc (void *ptr, size_t size)
	Change the size of an allocated memory block The contents will be unchanged in the range from the start of the region up to the minimum of the old and new sizes. If the new size is larger than the old size, the added memory will not be initialized. More...
void *	calloc (size_t nmemb, size_t size)
	Allocate memory for an array of elements The memory is set to zero. More...

Detailed Description

C-style dynamic memory allocation interface.

Function Documentation

malloc()

void * malloc

(

size_t

size

)

Allocate a memory block The memory is not initialized.

Parameters

size	Requested size of memory in bytes.

Returns

Pointer to memory or nullptr on error (no memory available) or if size was zero.

Optional:

Implement method

free()

void free

(

void *

ptr

)

Free an allocated memory block.

Parameters

ptr	Pointer to an previously allocated memory block.

Optional:

Implement method

realloc()

void * realloc	(	void *	ptr,
		size_t	size
	)

Change the size of an allocated memory block The contents will be unchanged in the range from the start of the region up to the minimum of the old and new sizes. If the new size is larger than the old size, the added memory will not be initialized.

Parameters

ptr	Pointer to an previously allocated memory block. If nullptr, then the call is equivalent to malloc().
size	New size of the memory block. If equal to zero, then the call is equivalent to free

Returns

Pointer to new memory block or nullptr on error

Optional:

Implement method

calloc()

void * calloc	(	size_t	nmemb,
		size_t	size
	)

Allocate memory for an array of elements The memory is set to zero.

Parameters

nmemb	Number of elements
size	Size of an element in bytes

Returns

pointer to the allocated memory or nullptr if the request fails

Optional:

Implement method