std::align

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Utilities library
Dynamic memory management
Low level memory management Allocators allocator allocator_traits (C++11) allocator_arg_t (C++11) allocator_arg (C++11) uses_allocator (C++11) scoped_allocator_adaptor (C++11) Uninitialized storage uninitialized_copy uninitialized_copy_n (C++11) uninitialized_fill uninitialized_fill_n raw_storage_iterator get_temporary_buffer return_temporary_buffer Smart pointers unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (deprecated) owner_less (C++11) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) Garbage collection support declare_reachable (C++11) undeclare_reachable (C++11) declare_no_pointers (C++11) undeclare_no_pointers (C++11) pointer_safety (C++11) get_pointer_safety (C++11) Miscellaneous pointer_traits (C++11) addressof (C++11) align (C++11) C Library malloc calloc realloc free

Defined in header <memory>
void* align( std::size_t alignment,              std::size_t size,              void*& ptr,              std::size_t& space);		(since C++11)

If it is possible to fit size bytes of storage aligned by alignment into the buffer pointed to by ptr with length space, the function modifies ptr to point to the first possible address of such aligned storage and decreases space by the number of bytes used for alignment. If it is impossible (the buffer is too small), align does nothing.

Contents 1 Parameters 2 Return value 3 Example 4 See also

[edit] Parameters

alignment	-	the desired alignment
size	-	the size of the storage to be aligned
ptr	-	pointer to contiguous storage of at least space bytes
space	-	the size of the buffer in which to operate

[edit] Return value

The adjusted value of ptr, or null pointer value if the space provided is too small.

[edit] Example

This section is incomplete

[edit] See also

alignof	(keyword)
alignas	(keyword)
aligned_storage (C++11)	defines the type suitable for use as uninitialized storage for types of given size (class template)