memalignment
From cppreference.com
C
Concurrency support (C11)
Program support utilities
Program termination
Unreachable control flow
(C23)
Communicating with the environment
(C11)
Memory alignment query
memalignment
(C23)
Signals
Signal types
Non-local jumps
Types
Defined in header
<stdlib.h>
size_t memalignment( const void *p );
(since C23)
Returns the maximum alignment satisfied by the provided address. The return value can be greater than any alignment value supported by the implementation. If p is a null pointer value, 0 is returned to indicate that the pointer cannot be used to access an object of any type.
If the return value compares is greater than or equal to alignof(T), the alignment requirement for the type T is satisfied by the pointer.
A freestanding implementation needs to provide memalignment.
[edit] Parameters
p
-
pointer to query alignment
[edit] Return value
The alignment value of p, or 0 if p is a null pointer value.
[edit] Notes
On common platforms where
- null pointers are cast to integer 0,
- pointer values are directly cast to the numeric values of virtual addresses, and
- size_t is same as uintptr_t ,
this function can be implemented as return (size_t )p & -(size_t )p;.
[edit] Example
Run this code
#include <stdio.h> #include <stdlib.h> int main() { alignas(128) int i = 0; printf ("%zu\n%zu\n", memalignment(nullptr), memalignment(&i)); }
Possible output:
0 128
[edit] References
- C23 standard (ISO/IEC 9899:2024):
- 7.24.9.1 The memalignment function (p: 374)