std::ranges::fill
cppreference.net에서
| 헤더 <algorithm>
|
||
| 에 정의됨 |
||
template< class T, std::output_iterator<const T&> O, std::sentinel_for<O> S >
constexpr O fill( O first, S last, const T& value );
|
호출 시그니처 | (1) (C++20부터) |
template< class O, std::sentinel_for<O> S, class T = std::iter_value_t<O> >
requires std::output_iterator<O, const T&>
constexpr O fill( O first, S last, const T& value );
|
(C++26까지) | |
template< class T, ranges::output_range<const T&> R >
constexpr ranges::borrowed_iterator_t<R> fill( R&& r, const T& value );
|
(C++26부터) | (2) (C++20부터) |
template< class R, class T = ranges::range_value_t<R> >
requires ranges::output_range<R, const T&>
constexpr ranges::borrowed_iterator_t<R> fill( R&& r, const T& value );
|
(C++26까지) | |
(C++26부터)1)
value 주어진 [first, last)를 범위 의 요소들에 할당합니다.2) (1)과 동일하지만,
r을 소스 범위로 사용합니다. 즉, ranges::begin(r)를 first로, ranges::end(r)를 last로 사용하는 것과 같습니다.이 페이지에 설명된 함수형 엔터티는 알고리즘 함수 객체 (비공식적으로 niebloids라고 함)입니다. 즉:
- 이들 중 하나를 호출할 때 명시적 템플릿 인자 목록을 지정할 수 없습니다.
- 그들 중 어느 것도 인자 종속 조회에 보이지 않습니다.
- 그들 중 하나가 함수 호출 연산자 왼쪽의 이름으로 일반 비한정 조회에 의해 발견되면, 인자 종속 조회가 억제됩니다.
매개변수
| first, last | - | 수정할 요소들의 범위 를 정의하는 반복자-감시자 쌍 |
| r | - | 수정할 요소들의 범위 |
| value | - | 할당할 값 |
반환값
last 와 비교 시 동일함을 나타내는 출력 반복자입니다.
복잡도
정확히 last - first 번의 할당.
가능한 구현
struct fill_fn { template<class O, std::sentinel_for<O> S, class T = std::iter_value_t<O>> requires std::output_iterator<O, const T&> constexpr O operator()(O first, S last, const T& value) const { while (first != last) *first++ = value; return first; } template<class R, class T = ranges::range_value_t<R>> requires ranges::output_range<R, const T&> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, const T& value) const { return (*this)(ranges::begin(r), ranges::end(r), value); } }; inline constexpr fill_fn fill; |
참고 사항
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_algorithm_default_value_type
|
202403
|
(C++26) | 목록 초기화 for algorithms ( 1,2 ) |
예제
이 코드 실행
#include <algorithm> #include <complex> #include <iostream> #include <vector> void println(const auto& seq) { for (const auto& e : seq) std::cout << e << ' '; std::cout << '\n'; } int main() { std::vector<int> v{0, 1, 2, 3, 4, 5}; // 오버로드 (1)을 사용하여 모든 요소를 -1로 설정 std::ranges::fill(v.begin(), v.end(), -1); println(v); // 오버로드 (2)를 사용하여 모든 요소를 10으로 설정 std::ranges::fill(v, 10); println(v); std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}}; println(nums); #ifdef __cpp_lib_algorithm_default_value_type std::ranges::fill(nums, {4, 2}); // T가 추론됨 #else std::ranges::fill(nums, std::complex<double>{4, 2}); #endif println(nums); }
출력:
-1 -1 -1 -1 -1 -1 10 10 10 10 10 10 (1,3) (2,2) (4,8) (4,2) (4,2) (4,2)
참고 항목
|
(C++20)
|
특정 개수의 요소에 값을 할당합니다
(알고리즘 함수 객체) |
|
(C++20)
(C++20)
|
요소들의 범위를 새로운 위치로 복사합니다
(알고리즘 함수 객체) |
|
(C++20)
|
함수의 결과를 범위에 저장합니다
(알고리즘 함수 객체) |
|
(C++20)
|
요소들의 범위에 함수를 적용합니다
(알고리즘 함수 객체) |
|
(C++26)
|
균일 난수 비트 생성기로부터 난수로 범위를 채웁니다
(알고리즘 함수 객체) |
|
주어진 값을 범위의 모든 요소에 복사 할당합니다
(함수 템플릿) |