Namespaces
Variants

    std::raw_storage_iterator

    ja.cppreference.net から
     
    C++
    コンパイラサポート
    フリースタンディングとホステッド
    言語
    標準ライブラリ
    標準ライブラリヘッダ
    名前付き要件
    機能テストマクロ (C++20)
    言語サポートライブラリ
    コンセプトライブラリ (C++20)
    診断ライブラリ
    メモリ管理ライブラリ
    メタプログラミングライブラリ (C++11)
    一般ユーティリティライブラリ
    コンテナライブラリ
    イテレータライブラリ
    レンジライブラリ (C++20)
    アルゴリズムライブラリ
    文字列ライブラリ
    テキスト処理ライブラリ
    数値ライブラリ
    日時ライブラリ
    入出力ライブラリ
    ファイルシステムライブラリ (C++17)
    並行性サポートライブラリ (C++11)
    実行制御ライブラリ (C++26)
    技術仕様書
    記号索引
    外部ライブラリ
     
    メモリ管理ライブラリ
    アロケータ
    (C++17)
    (C++20)
    メモリリソース
    未初期化ストレージ (C++20まで*)
    ガベージコレクタサポート (C++23まで)
     
    std::raw_storage_iterator
     
    ヘッダで定義 <memory> 
    template< class OutputIt, class T >
class raw_storage_iterator
    : public std::iterator<std::output_iterator_tag, void, void, void, void>;
    		(C++17まで) 
    template< class OutputIt, class T >
class raw_storage_iterator;
    		(C++17から)
    (C++17で非推奨)
    (C++20で削除)

    出力イテレータ std::raw_storage_iterator により、標準アルゴリズムが結果を未初期化メモリに格納できるようになります。アルゴリズムが型 T のオブジェクトを逆参照されたイテレータに書き込むと、そのオブジェクトはイテレータが指す未初期化ストレージ内の位置にコピー構築されます。テンプレートパラメータ OutputIt は、LegacyOutputIterator の要件を満たし、かつ operator* がオブジェクトを返すように定義されており、その operator& は型 T* のオブジェクトを返します。通常、型 T* が OutputIt として使用されます。

    型要件

    -
    OutputIt は LegacyOutputIterator の要件を満たさなければならない。

    メンバー関数

    		新しい raw_storage_iterator を作成する
    (public member function)
    		バッファ内の指し示す位置にオブジェクトを構築する
    (public member function)
    		イテレータをデリファレンスする
    (public member function)
    		イテレータを進める
    (public member function)
    (since C++17)
    		ラップされたイテレータへのアクセスを提供する
    (public member function)

    メンバー型

    メンバー型 定義
    iterator_category std:: output_iterator_tag
    value_type void
    difference_type

    void

    		(C++20以前)

    std::ptrdiff_t

    		(C++20以降)
    pointer void
    reference void

    メンバ型 iterator_category , value_type , difference_type , pointer および reference は、 std:: iterator < std:: output_iterator_tag , void , void , void , void > からの継承によって取得されることが要求される。

    		(C++17まで)

    注記

    std::raw_storage_iterator が非推奨となった主な理由は、例外安全性に欠ける動作によるものです。 std::uninitialized_copy とは異なり、 std::copy などの操作中に例外が発生した場合に安全に処理できず、正常に構築されたオブジェクトの数と例外発生時の適切な破棄を追跡する仕組みがないため、リソースリークを引き起こす可能性があります。

    例

    このコードを実行 
    #include <algorithm>
#include <iostream>
#include <memory>
#include <string>
int main()
{
    const std::string s[] = {"This", "is", "a", "test", "."};
    std::string* p = std::allocator<std::string>().allocate(5);
    std::copy(std::begin(s), std::end(s),
              std::raw_storage_iterator<std::string*, std::string>(p));
    for (std::string* i = p; i != p + 5; ++i)
    {
        std::cout << *i << '\n';
        i->~basic_string<char>();
    }
    std::allocator<std::string>().deallocate(p, 5);
}

    出力: 

    This
is
a
test
.

    関連項目

    (C++11)
    		 アロケータ型に関する情報を提供します
    (クラステンプレート)
    (C++11)
    		 マルチレベルコンテナ用のマルチレベルアロケータを実装します
    (クラステンプレート)
    (C++11)
    		 指定された型がuses-allocator構築をサポートしているかどうかを調べます
    (クラステンプレート)
    		オブジェクトの範囲を未初期化のメモリ領域にコピーします
    (関数テンプレート & アルゴリズム関数オブジェクト)
    (C++20)