Defined in header <stdlib.h> | ||
| (since C23) | ||
Ifptr is a null pointer or the result obtained from a call toaligned_alloc, wherealignment is equal to the requested allocation alignment andsize is equal to the requested allocation size, this function is equivalent tofree(ptr). Otherwise, the behavior is undefined.
The result of anmalloc,calloc, orrealloc call may not be passed tofree_aligned_sized.
free_aligned_sized is thread-safe: it behaves as though only accessing the memory locations visible through its argument, and not any static storage.
A call tofree_aligned_sized that deallocates a region of memorysynchronizes-with a call to any subsequent allocation function that allocates the same or a part of the same region of memory. This synchronization occurs after any access to the memory by the deallocating function and before any access to the memory by the allocation function. There is a single total order of all allocation and deallocation functions operating on each particular region of memory.
Contents |
| ptr | - | pointer to the memory to deallocate |
| alignment | - | alignment of memory to deallocate |
| size | - | size of memory to deallocate |
(none)
| This section is incomplete Reason: no example |
(C11) | allocates aligned memory (function)[edit] |
| deallocates previously allocated memory (function)[edit] | |
(C23) | deallocates previously allocated sized memory (function)[edit] |
| allocates memory (function)[edit] |