查看“︁cpp/types/aligned storage”︁的源代码

因为以下原因，您没有权限编辑该页面：

您请求的操作仅限属于这些用户组的用户执行：用户、管理员

您可以查看和复制此页面的源代码。

{{cpp/title|aligned_storage}}
{{cpp/meta/navbar}}
{{dcl begin}}
{{dcl header|type_traits}}
{{dcl|since=c++11|deprecated=c++23|1=
template< std::size_t Len, std::size_t Align = /* 默认对齐 */ >
struct aligned_storage;
}}
{{dcl end}}

提供嵌套类型 ''{{tt|type}}''，它满足{{named req|TrivialType}}和{{named req|StandardLayoutType}}，适于作为大小至多为 {{tt|Len}} 且[[cpp/language/object#对齐|对齐要求]]为 {{tt|Align}} 的因数的任意对象的未初始化存储。

{{tt|Align}} 的默认值是大小至多为 {{tt|Len}} 的任意对象的最强（最大）对齐要求。若不使用默认值，则 {{tt|Align}} 对于某类型 {{tt|T}} 必须为 {{c|alignof(T)}} 的值，否则行为未定义。

若 {{c|1=Len == 0}} 则行为未定义。

是否支持任何[[cpp/language/object#对齐|扩展对齐]]是实现定义的。

{{cpp/types/nospec}}

===成员类型===
{{dsc begin}}
{{dsc hitem|名称|定义}}
{{dsc|{{tt|type}}|长度至少为 {{tt|Len}} 并拥有对齐要求 {{tt|Align}} 的平凡兼标准布局类型}}
{{dsc end}}

===辅助类型===
{{dcl begin}}
{{dcl|since=c++14|deprecated=c++23|1=
template< std::size_t Len, std::size_t Align = /* 默认对齐 */ >
using aligned_storage_t = typename aligned_storage<Len, Align>::type;
}}
{{dcl end}}

===注解===
{{tt|std::aligned_storage<>::type}} 所定义的类型能用于创建适合保有给定类型对象的未初始化内存块，可选地进行比其自然对齐要求更严格的对齐，例如在缓存或页的边界上。

同任何其他未初始化存储，使用[[cpp/language/new|布置 new]] 创建对象，并以显式的析构函数调用销毁它们。

===可能的实现===
除了默认实参，{{tt|aligned_storage}} 也能通过 {{tt|alignas}} 表达：
{{eq fun
|1=
template<std::size_t Len, std::size_t Align /* 未实现默认对齐 */>
struct aligned_storage
{
    struct type
    {
        alignas(Align) unsigned char data[Len];
    };
};
}}

===示例===
{{example
|初步的静态 vector 类，演示在对齐存储中创建、访问及析构对象。
|code=
#include <cstddef>
#include <iostream>
#include <new>
#include <string>
#include <type_traits>

template<class T, std::size_t N>
class static_vector
{
    // N 个 T 的正确对齐的未初始化存储
    std::aligned_storage_t<sizeof(T), alignof(T)> data[N];
    std::size_t m_size = 0;

public:
    // 在对齐的存储中创建对象
    template<typename ...Args> void emplace_back(Args&&... args) 
    {
        if( m_size >= N ) // 可能的错误处理
            throw std::bad_alloc{};

        // 用原位 operator new 在对齐的存储中构造值
        ::new(&data[m_size]) T(std::forward<Args>(args)...);
        ++m_size;
    }

    // 在对齐的存储中访问对象
    const T& operator[](std::size_t pos) const 
    {
        // 注意：在 P0137R1 中的对象模型更改后需要 std::launder
        return *std::launder(reinterpret_cast<const T*>(&data[pos]));
    }

    // 从对齐的存储中销毁对象
    ~static_vector() 
    {
        for(std::size_t pos = 0; pos < m_size; ++pos) {
            // 注意：在 P0137R1 中的对象模型更改后需要 std::launder
            std::destroy_at(std::launder(reinterpret_cast<T*>(&data[pos])));
        }
    }
};

int main()
{
    static_vector<std::string, 10> v1;
    v1.emplace_back(5, '*');
    v1.emplace_back(10, '*');
    std::cout << v1[0] << '\n' << v1[1] << '\n';
}
|output=
*****
**********
}}

===参阅===
{{dsc begin}}
{{dsc inc|cpp/language/dsc alignas}}
{{dsc inc|cpp/types/dsc alignment_of}}
{{dsc inc|cpp/memory/c/dsc aligned_alloc}}
{{dsc inc|cpp/types/dsc aligned_union}}
{{dsc inc|cpp/types/dsc max_align_t}}
{{dsc inc|cpp/utility/dsc launder}}
{{dsc end}}

{{langlinks|de|en|es|fr|it|ja|pt|ru}}

该页面使用的模板：

Template:!（查看源代码）
Template:!-（查看源代码）
Template:=（查看源代码）
Template:c（查看源代码）
Template:c/core（查看源代码）
Template:cpp/language/dsc alignas（查看源代码）
Template:cpp/memory/c/dsc aligned alloc（查看源代码）
Template:cpp/meta/navbar（查看源代码）
Template:cpp/meta/navbar content（查看源代码）
Template:cpp/meta/navbar heading（查看源代码）
Template:cpp/navbar content（查看源代码）
Template:cpp/navbar heading（查看源代码）
Template:cpp/title（查看源代码）
Template:cpp/types/dsc aligned union（查看源代码）
Template:cpp/types/dsc alignment of（查看源代码）
Template:cpp/types/dsc max align t（查看源代码）
Template:cpp/types/nospec（查看源代码）
Template:cpp/utility/dsc launder（查看源代码）
Template:ctitle（查看源代码）
Template:dcl（查看源代码）
Template:dcl/std（查看源代码）
Template:dcl begin（查看源代码）
Template:dcl end（查看源代码）
Template:dcl header（查看源代码）
Template:dcl sep（查看源代码）
Template:dsc（查看源代码）
Template:dsc begin（查看源代码）
Template:dsc editlink（查看源代码）
Template:dsc end（查看源代码）
Template:dsc fun（查看源代码）
Template:dsc guard（查看源代码）
Template:dsc header/link（查看源代码）
Template:dsc hitem（查看源代码）
Template:dsc inc（查看源代码）
Template:dsc member（查看源代码）
Template:dsc tclass（查看源代码）
Template:dsc tfun（查看源代码）
Template:dsc typedef（查看源代码）
Template:eq fun（查看源代码）
Template:example（查看源代码）
Template:get lang（查看源代码）
Template:langlinks（查看源代码）
Template:langlinks/one（查看源代码）
Template:lines（查看源代码）
Template:lt（查看源代码）
Template:ltt/core（查看源代码）
Template:mark（查看源代码）
Template:mark c++11（查看源代码）
Template:mark c++14（查看源代码）
Template:mark c++17（查看源代码）
Template:mark c++20（查看源代码）
Template:mark c++23（查看源代码）
Template:mark c++26（查看源代码）
Template:mark deprecated c++20（查看源代码）
Template:mark deprecated c++23（查看源代码）
Template:mark deprecated c++26（查看源代码）
Template:mark fun（查看源代码）
Template:mark life（查看源代码）
Template:mark rev（查看源代码）
Template:mark since c++11（查看源代码）
Template:mark since c++14（查看源代码）
Template:mark tclass（查看源代码）
Template:mark tfun（查看源代码）
Template:mark tooltip（查看源代码）
Template:mark typedef（查看源代码）
Template:named req（查看源代码）
Template:named req/core（查看源代码）
Template:named req/legacy map（查看源代码）
Template:named req/translate（查看源代码）
Template:navbar（查看源代码）
Template:navbar editlink（查看源代码）
Template:nbsp（查看源代码）
Template:nbspt（查看源代码）
Template:nv（查看源代码）
Template:nv begin（查看源代码）
Template:nv col begin（查看源代码）
Template:nv col end（查看源代码）
Template:nv col next（查看源代码）
Template:nv end（查看源代码）
Template:nv h1（查看源代码）
Template:nv h2（查看源代码）
Template:nv ln（查看源代码）
Template:nv ph（查看源代码）
Template:small（查看源代码）
Template:source（查看源代码）
Template:title（查看源代码）（受保护）
Template:tooltip（查看源代码）
Template:trim（查看源代码）
Template:tt（查看源代码）
Template:ttb（查看源代码）

返回cpp/types/aligned storage。

cppreference.com

搜索

命名空间

语言变体

查看

操作

查看“︁cpp/types/aligned storage”︁的源代码

导航

工具