std::alignment_of

Defined in header `<type_traits>`
template< class T > struct alignment_of;		(since C++11)

Provides the member constant value equal to the alignment requirement of the type T, as if obtained by an alignof expression. If T is an array type, returns the alignment requirements of the element type. If T is a reference type, returns the alignment requirements of the type referred to.

If alignof(T) is not a valid expression, the behavior is undefined.

Helper variable template

template< class T > inline constexpr std::size_t alignment_of_v = alignment_of<T>::value;		(since C++17)

Inherited from std::integral_constant

Member constants

value

[static]

alignof(T)
(public static member constant)

Member functions

operator std::size_t	converts the object to std::size_t, returns `value` (public member function)
operator() (C++14)	returns `value` (public member function)

Member types

Type	Definition
`value_type`	`std::size_t`
`type`	std::integral_constant<std::size_t, value>

Possible implementation

template< class T >
struct alignment_of : std::integral_constant<
                          std::size_t,
                          alignof(T)
                       > {};

Notes

This type trait predates the alignof keyword, which can be used to obtain the same value with less verbosity.

Example

Run this code

#include <iostream>
#include <type_traits>
 
class A {};
 
int main() 
{
    std::cout << std::alignment_of<A>::value << '\n';
    std::cout << std::alignment_of<int>() << '\n'; // alt syntax
    std::cout << std::alignment_of_v<double> << '\n'; // c++17 alt syntax
}

Output:

1
4
8

alignof operator	queries alignment requirements of a type (since C++11)
aligned_storage (C++11)	defines the type suitable for use as uninitialized storage for types of given size (class template)
aligned_union (C++11)	defines the type suitable for use as uninitialized storage for all given types (class template)
max_align_t (C++11)	POD type with alignment requirement as great as any other scalar type (typedef)

Language
Standard library headers
Concepts
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)
Filesystem library (C++17)
Technical Specifications

Type support (basic types, RTTI, type traits)
Dynamic memory management
Error handling
Program utilities
Variadic functions
Date and time
Function objects
initializer_list (C++11)
bitset
hash (C++11)
Relational operators
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
`optional`, `any` and `variant` (C++17)
optional
any
variant
in_placein_place_typein_place_indexin_place_tin_place_type_tin_place_index_t
Pairs and tuples
pair
tuple (C++11)
apply (C++17)
make_from_tuple (C++17)
piecewise_construct_t (C++11)
piecewise_construct (C++11)
integer_sequence (C++14)
Swap, forward and move
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
Elementary string conversions
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
Type operations
declval (C++11)
as_const (C++17)