std:: aligned_storage

ネストされた型 type を提供します。この型は TrivialType および StandardLayoutType を満たし、サイズが最大 Len で アライメント要件 が Align の約数である任意のオブジェクトの未初期化ストレージとして使用するのに適しています。

Align のデフォルト値は、サイズが Len 以下のオブジェクトの中で最も厳格な（最大の）アライメント要件です。デフォルト値を使用しない場合、 Align は何らかの型 T に対する alignof ( T ) の値でなければならず、そうでない場合の動作は未定義です。

Len == 0 の場合、動作は未定義です。

いずれかの extended alignment がサポートされるかどうかは実装定義です。

プログラムが std::aligned_storage に対する特殊化を追加する場合、動作は未定義です。

メンバー型

ヘルパー型

注記

std::aligned_storage<>::type によって定義される型は、指定された型のオブジェクトを保持するのに適した未初期化メモリブロックを作成するために使用できます。オプションで、自然なアラインメント要件よりも厳格に、例えばキャッシュやページ境界に配置することが可能です。

他の未初期化ストレージと同様に、オブジェクトは placement new を使用して作成され、明示的なデストラクタ呼び出しによって破棄されます。

実装例

デフォルト引数を除いて、aligned_storageはalignasで表現可能です：

template<std::size_t Len, std::size_t Align = /* default alignment not implemented */>
struct aligned_storage
{
    struct type
    {
        alignas(Align) unsigned char data[Len];
    };
};

例

#include <cstddef>
#include <iostream>
#include <new>
#include <string>
#include <type_traits>
template<class T, std::size_t N>
class static_vector
{
    // Properly aligned uninitialized storage for N T's
    std::aligned_storage_t<sizeof(T), alignof(T)> data[N];
    std::size_t m_size = 0;
public:
    // Create an object in aligned storage
    template<typename ...Args> void emplace_back(Args&&... args)
    {
        if (m_size >= N) // Possible error handling
            throw std::bad_alloc{};
        // Construct value in memory of aligned storage using inplace operator new
        ::new(&data[m_size]) T(std::forward<Args>(args)...);
        ++m_size;
    }
    // Access an object in aligned storage
    const T& operator[](std::size_t pos) const
    {
        // Note: std::launder is needed after the change of object model in P0137R1
        return *std::launder(reinterpret_cast<const T*>(&data[pos]));
    }
    // Destroy objects from aligned storage
    ~static_vector()
    {
        for (std::size_t pos = 0; pos < m_size; ++pos)
            // Note: std::launder is needed after the change of object model in P0137R1
            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';
}

*****
**********

関連項目