Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      alignof operator(since C++11)

      From cppreference.com
      <cpp‎ |language
       
       
      C++ language
      General topics
      Flow control
      Conditional execution statements
      Iteration statements (loops)
      Jump statements
      Functions
      Function declaration
      Lambda function expression
      inline specifier
      Dynamic exception specifications(until C++17*)
      noexcept specifier(C++11)
      Exceptions
      Namespaces
      Types
      Specifiers
      constexpr(C++11)
      consteval(C++20)
      constinit(C++20)
      Storage duration specifiers
      Initialization
      Expressions
      Alternative representations
      Literals
      Boolean -Integer -Floating-point
      Character -String -nullptr(C++11)
      User-defined(C++11)
      Utilities
      Attributes(C++11)
      Types
      typedef declaration
      Type alias declaration(C++11)
      Casts
      Memory allocation
      Classes
      Class-specific function properties
      Special member functions
      Templates
      Miscellaneous
       
      Expressions
      General
      Literals
      Operators
      Conversions
       

      Queries alignment requirements of a type.

      Contents

      [edit]Syntax

      alignof(type-id)

      Returns a value of typestd::size_t.

      [edit]Explanation

      Returnsthe alignment, in bytes, required for any instance of the type indicated bytype-id, which is eithercomplete object type, an array type whose element type is complete, or a reference type to one of those types.

      If the type is reference type, the operator returns the alignment of referenced type; if the type is array type, alignment requirement of the element type is returned.

      [edit]Notes

      Seealignment for the meaning and properties of the value returned byalignof.

      [edit]Keywords

      alignof

      [edit]Example

      Run this code
      #include <iostream> struct Foo{int   i;float f;char  c;}; // Note: alignas(alignof(long double)) below can be// simplified to alignas(long double) if desired.struct alignas(alignof(longdouble)) Foo2{// put your definition here};  struct Empty{}; struct alignas(64) Empty64{}; #define SHOW(expr) std::cout << #expr << " = " << (expr) << '\n' int main(){    SHOW(alignof(char));    SHOW(alignof(int*));    SHOW(alignof(Foo));    SHOW(alignof(Foo2));    SHOW(alignof(Empty));    SHOW(alignof(Empty64));}

      Possible output:

      alignof(char) = 1alignof(int*) = 8alignof(Foo) = 4alignof(Foo2) = 16alignof(Empty) = 1alignof(Empty64) = 64

      [edit]Defect reports

      The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

      DRApplied toBehavior as publishedCorrect behavior
      CWG 1305C++11type-id could not represent a reference to an array
      with an unknown bound but a complete element type
      allowed

      [edit]References

      • C++23 standard (ISO/IEC 14882:2024):
      • 7.6.2.6 Alignof [expr.alignof]
      • C++20 standard (ISO/IEC 14882:2020):
      • 7.6.2.5 Alignof [expr.alignof]
      • C++17 standard (ISO/IEC 14882:2017):
      • 8.3.6 Alignof [expr.alignof]
      • C++14 standard (ISO/IEC 14882:2014):
      • 5.3.6 Alignof [expr.alignof]
      • C++11 standard (ISO/IEC 14882:2011):
      • 5.3.6 Alignof [expr.alignof]

      [edit]See also

      Alignment requirement restricts the addresses at which an object may be allocated
      alignas(C++11) specifies that the storage for the variable should be aligned by specific amount
      (specifier)[edit]
      obtains the type's alignment requirements
      (class template)[edit]
      C documentation for_Alignof,alignof operator
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/language/alignof&oldid=180155"

      [8]ページ先頭

      ©2009-2025 Movatter.jp