4. fill

最終更新日時(UTC):
が更新

履歴 編集

function template
<algorithm>

std::fill

namespace std {
  template <class ForwardIterator,
            class T>
  void
    fill(ForwardIterator first,
         ForwardIterator last,
         const T& value);        // (1) C++03
  template <class ForwardIterator,
            class T>
  constexpr void
    fill(ForwardIterator first,
         ForwardIterator last,
         const T& value);        // (1) C++20
  template <class ForwardIterator,
            class T = typename iterator_traits<ForwardIterator>::value_type>
  constexpr void
    fill(ForwardIterator first,
         ForwardIterator last,
         const T& value);        // (1) C++20

  template <class ExecutionPolicy,
            class ForwardIterator,
            class T>
  void
    fill(ExecutionPolicy&& exec,
         ForwardIterator first,
         ForwardIterator last,
         const T& value);        // (2) C++17
  template <class ExecutionPolicy,
            class ForwardIterator,
            class T = typename iterator_traits<ForwardIterator>::value_type>
  void
    fill(ExecutionPolicy&& exec,
         ForwardIterator first,
         ForwardIterator last,
         const T& value);        // (2) C++26
}

概要

イテレータ範囲[first, last)のすべての要素に指定された値を書き込む。

適格要件

value は output iterator へ書き込み可能でなければならない

効果

[first,last) 内の全ての要素に value を代入する

計算量

正確に last - first 回の代入を行う

備考

例

基本的な使い方

#include <algorithm>
#include <iostream>
#include <vector>

int main() {
  std::vector<int> v(5);

  // v を 3 の値で埋める
  std::fill(v.begin(), v.end(), 3);

  std::for_each(v.begin(), v.end(), [](int x) { std::cout << x << ","; });
}

出力

3,3,3,3,3,

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

#include <algorithm>
#include <iostream>
#include <vector>

struct Point {
  int x;
  int y;

  bool operator==(const Point& other) const = default;
};

int main() {
  std::vector<Point> v(5);

  std::fill(v.begin(), v.end(), {1, 2});

  for (const Point& p : v) {
    std::cout << p.x << "," << p.y << std::endl;
  }
}

出力

1,2
1,2
1,2
1,2
1,2

実装例

template <class ForwardIterator, class T>
void fill(ForwardIterator first, ForwardIterator last, const T& value) {
  while (first != last)
    *first++ = value;
}

参照