名前空間
変種
    操作

      std::uninitialized_default_construct_n

      提供: cppreference.com
      < cpp‎ | memory
       
      C++
       
      ユーティリティライブラリ
      汎用ユーティリティ
      日付と時間
      関数オブジェクト
      書式化ライブラリ(C++20)
      (C++11)
      (C++14)
      関係演算子 (C++20で非推奨)
      整数比較関数
      (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
      (C++20)
      スワップと型操作
      (C++20)
      (C++14)
      (C++11)
      (C++11)
      (C++11)
      (C++11)
      (C++17)
      一般的な語彙の型
      (C++11)
      (C++17)
      (C++17)
      (C++17)
      (C++17)
      (C++17)

      初等文字列変換
      (C++17)
      (C++17)
      (C++17)
       
      動的メモリ管理
      未初期化記憶域
      (C++11)
      (C++17)
      uninitialized_default_construct_n
      (C++17)
      (C++17)
      (C++17)
      (C++20)
      (C++20未満)
      (C++20未満)
      (C++20未満)
      ガベージコレクションサポート
      (C++11)
      (C++11)
      (C++11)
      (C++11)
      (C++11)
      (C++11)
      その他
      (C++11)
      (C++20)
      (C++11)
      (C++11)
      (C++20)
      C のライブラリ
      低水準のメモリ管理
       
      ヘッダ <memory> で定義
      template<class ForwardIt, class Size >
      ForwardIt uninitialized_default_construct_n( ForwardIt first, Size n );
      		 (1) (C++17以上)
      template<class ExecutionPolicy, class ForwardIt, class Size >
      ForwardIt uninitialized_default_construct_n( ExecutionPolicy&& policy, ForwardIt first, Size n );
      		 (2) (C++17以上)
      1) 以下のように行われたかのように、 first から始まる未初期化記憶域に typename iterator_traits<ForwardIt>::value_type 型のオブジェクト n 個をデフォルト初期化によって構築します。 
      for(; n >0;(void)++first, --n)::new(static_cast<void*>(std::addressof(*first)))typenamestd::iterator_traits<ForwardIt>::value_type;
      初期化中に例外が投げられた場合、すでに構築されたオブジェクトは未規定の順序で破棄されます。
      2)(1) と同じですが、 policy に従って実行されます。 このオーバーロードは、 std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> が true でなければ、オーバーロード解決に参加しません。

      目次

      [編集]引数

      first - 初期化する要素の範囲の先頭
      n - 初期化する要素の数
      policy - 使用する実行ポリシー。 詳細は実行ポリシーを参照してください
      型の要件
      -
      ForwardIt は LegacyForwardIterator の要件を満たさなければなりません。
      -
      ForwardIt の有効なインスタンスのインクリメント、代入、比較、間接参照は例外を投げてはなりません。

      [編集]戻り値

      オブジェクトの範囲の終端 (すなわち std::next(first, n))。

      [編集]計算量

      n に比例。

      [編集]例外

      テンプレート引数 ExecutionPolicy を持つオーバーロードは以下のようにエラーを報告します。

      • アルゴリズムの一部として呼び出された関数の実行が例外を投げ、 ExecutionPolicy が標準のポリシーのいずれかの場合は、 std::terminate が呼ばれます。 それ以外のあらゆる ExecutionPolicy については、動作は処理系定義です。
      • アルゴリズムがメモリの確保に失敗した場合は、 std::bad_alloc が投げられます。

      [編集]実装例

      template<class ForwardIt, class Size> ForwardIt uninitialized_default_construct_n( ForwardIt first, Size n ){using T =typenamestd::iterator_traits<ForwardIt>::value_type; ForwardIt current = first;try{for(; n >0;(void)++current, --n){::new(static_cast<void*>(std::addressof(*current))) T;}return current;}catch(...){std::destroy(first, current);throw;}}

      [編集]例

      This section is incomplete
      Reason: no example

      [編集]関連項目

      (C++17)
      		 オブジェクトをデフォルト初期化によりメモリの未初期化領域の指定範囲に構築します
      (関数テンプレート)[edit]
      (C++17)
      		 オブジェクトを値初期化によりメモリの未初期化領域に指定個数構築します
      (関数テンプレート)[edit]
      「https://ja.cppreference.com/mwiki/index.php?title=cpp/memory/uninitialized_default_construct_n&oldid=49318」から取得
      close