aligned_alloc

 

C

Language

Standard Library

Type support

Dynamic memory management

Error handling

Program utilities

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

 

Dynamic memory management

malloc

calloc

realloc

free

aligned_alloc (C11)

 

Defined in header <stdlib.h>
void *aligned_alloc( size_t alignment, size_t size );		(since C11)

Allocate size bytes of uninitialized storage whose alignment is specified by alignment. The size parameter should be an integral multiple of alignment.

Parameters

alignment	-	specifies the alignment. Shall be a valid alignment supported by the implementation.
size	-	number of bytes to allocate. An integral multiple of alignment

Return value

Either a NULL pointer or a pointer to the allocated memory. The pointer must be deallocated with free().

Notes

Passing a size which is not an integral multiple of alignment or a alignment which is not valid or not supported by the implementation is undefined behavior (See J.2 in C11).

E.g., the glibc requires alignment to be a power of two and a multiple of sizeof(void *).

References

• C11 standard (ISO/IEC 9899:2011):

• 7.22.3.1 Memory management functions

See also

C++ documentation for aligned storage