最終更新日時(UTC): 2026年05月18日 03時32分26秒
Akira Takahashi が更新

履歴 編集

function template
<memory>

# std::uninitialized_fill_n

    namespace std {
      template <class ForwardIterator, class Size, class T>
      ForwardIterator
        uninitialized_fill_n(ForwardIterator first,
                             Size n,
                             const T& x);           // (1) C++03
      template <class NoThrowForwardIterator,
                class Size,
                class T = typename iterator_traits<NoThrowForwardIterator>::value_type>
      constexpr NoThrowForwardIterator
        uninitialized_fill_n(NoThrowForwardIterator first,
                             Size n,
                             const T& x);           // (1) C++26

      template <class ExecutionPolicy, class ForwardIterator, class Size, class T>
      ForwardIterator
        uninitialized_fill_n(ExecutionPolicy&& exec,
                             ForwardIterator first,
                             Size n,
                             const T& x);           // (2) C++17
      template <class ExecutionPolicy,
                class NoThrowForwardIterator,
                class Size,
                class T = typename iterator_traits<NoThrowForwardIterator>::value_type>
      NoThrowForwardIterator
        uninitialized_fill_n(ExecutionPolicy&& exec,
                             NoThrowForwardIterator first,
                             Size n,
                             const T& x);           // (2) C++26
    }

## 概要

未初期化領域の範囲のうち、先頭`N`個の要素を指定された値で配置`new`する。

未初期化入力イテレータ範囲`[first, first + n)`を初期化しつつ値`x`で埋める。

## 効果

- C++03 : 以下と等価

      for (; n--; ++first)
        ::new (static_cast<void*>(&*first))
           typename iterator_traits<ForwardIterator>::value_type(x);

- C++17 : 以下と等価

      for (; n--; ++first)
        ::new (static_cast<void*>(addressof(*first)))
           typename iterator_traits<ForwardIterator>::value_type(x);

## 戻り値

`first`

## 例外

呼び出すコンストラクタなどから例外が送出された場合、その例外がこの関数の外側に伝播される前に、その時点で構築済のオブジェクトは全て未規定の順序で破棄される。すなわち、例外が送出された場合は初期化対象領域は未初期化のままとなる。

## 備考

- (1), (2) :
  - C++26 : 引数として波カッコ初期化`{}`を受け付ける

        std::uninitialized_fill_n(p, n, {a, b});

## 例

### 基本的な使い方

    #include <iostream>
    #include <memory>
    #include <algorithm>

    int main()
    {
      std::allocator<int> alloc;

      // メモリ確保。
      // この段階では、[p, p + size)の領域は未初期化
      const std::size_t size = 3;
      int* p = alloc.allocate(size);

      // 未初期化領域の範囲[p, p + size)を初期化しつつ、値2で埋める
      std::uninitialized_fill_n(p, size, 2);

      // pの領域が初期化され、かつ範囲pの全ての要素が2で埋められているか確認
      std::for_each(p, p + size, [](int x) {
        std::cout << x << std::endl;
      });

      // 要素を破棄
      for (std::size_t i = 0; i < size; ++i) {
        alloc.destroy(p + i);
      }

      // メモリ解放
      alloc.deallocate(p, size);
    }

#### 出力

    2
    2
    2

### 波カッコ初期化を入力として使用する (C++26)

    #include <iostream>
    #include <memory>

    struct Point {
      int x;
      int y;
    };

    int main()
    {
      std::allocator<Point> alloc;

      const std::size_t size = 3;
      Point* p = alloc.allocate(size);

      // 波カッコ初期化を直接渡せる
      std::uninitialized_fill_n(p, size, {1, 2});

      for (std::size_t i = 0; i < size; ++i) {
        std::cout << p[i].x << "," << p[i].y << std::endl;
      }

      for (std::size_t i = 0; i < size; ++i) {
        std::destroy_at(p + i);
      }
      alloc.deallocate(p, size);
    }

#### 出力

    1,2
    1,2
    1,2

## 関連項目

- `ranges::uninitialized_fill_n`

## 参照

- LWG Issue 2433 `uninitialized_copy()`/etc. should tolerate overloaded `operator&`
- P3508R0 Wording for "constexpr for specialized memory algorithms"
  - C++26から`constexpr`がついた
- P3787R2 Adjoints to "Enabling list-initialization for algorithms": uninitialized_fill
  - C++26で値型をイテレータから推論するよう拡張され、波カッコ初期化を直接渡せるようになった