namespace std {
template <class OutputIterator, class Size, class T>
void
fill_n(OutputIterator first,
Size n,
const T& value); // (1) C++03
template <class OutputIterator, class Size, class T>
OutputIterator
fill_n(OutputIterator first,
Size n,
const T& value); // (1) C++11
template <class OutputIterator, class Size, class T>
constexpr OutputIterator
fill_n(OutputIterator first,
Size n,
const T& value); // (1) C++20
template <class ExecutionPolicy, class ForwardIterator,
class Size, class T>
ForwardIterator
fill_n(ExecutionPolicy&& exec,
ForwardIterator first,
Size n,
const T& value); // (2) C++17
}
概要
イテレータ範囲[first, first + n)
のすべての要素に指定された値を書き込む。
要件
value
はoutput iterator
へ書き込み可能でなければならない。Size
はintegral type
に変換可能でなければならない。
効果
n
が 1 以上の場合は [first,first + n)
内の全ての要素に value
を代入し、そうでない場合は何もしない。
戻り値
- C++03 まで
無し - C++11 から
n
が 1 以上の場合はfirst + n
、そうでない場合はfirst
を返す。
計算量
n
が 1 以上の場合は n
回、そうでない場合は 0 回の代入を行う。
例
#include <algorithm>
#include <iostream>
#include <iterator>
int main() {
// 3 を出力しまくる
std::fill_n(std::ostream_iterator<int>(std::cout, ","), 10, 3);
}
9
#include <algorithm>
#include <iostream>
#include <iterator>
int main() {
// 3 を出力しまくる
std::fill_n(std::ostream_iterator<int>(std::cout, ","), 10, 3);
}
出力
3,3,3,3,3,3,3,3,3,3,
実装例
template <class OutputIterator, class Size, class T>
# if __cplusplus >= 201103L
OutputIterator
# else
void
# endif
fill_n(OutputIterator first, Size n, const T& value) {
while (n-- > 0)
*first++ = value;
# if __cplusplus >= 201103L
return first;
# endif
}
処理系
- Clang:
- GCC:
- ICC:
- Visual C++: 2010 ✅, 2012 ✅, 2013 ✅, 2015 ✅
- C++11への対応(戻り値の変更)は2012から。