std::fill
cppreference.net에서
| 헤더에 정의됨 <algorithm>
|
||
template< class ForwardIt, class T >
void fill( ForwardIt first, ForwardIt last, const T& value );
|
(1) | (until C++26) (constexpr since C++20) |
template< class ForwardIt, class T = typename std::iterator_traits
<ForwardIt>::value_type >
constexpr void fill( ForwardIt first, ForwardIt last,
const T& value );
|
(since C++26) | |
template< class ExecutionPolicy, class ForwardIt, class T >
void fill( ExecutionPolicy&& policy,
ForwardIt first, ForwardIt last, const T& value );
|
(2) | (since C++17) (until C++26) |
template< class ExecutionPolicy,
class ForwardIt, class T = typename std::iterator_traits
<ForwardIt>::value_type >
void fill( ExecutionPolicy&& policy,
ForwardIt first, ForwardIt last, const T& value );
|
(since C++26) | |
1) 주어진
value를 범위 [first, last)의 모든 요소에 할당합니다.2) (1)과 동일하지만,
policy에 따라 실행됩니다. 이 오버로드는 다음 표현식의 값이
true:|
|
(until C++20) |
|
|
(since C++20) |
만약 value가 writable to first이 아니라면, 프로그램은 ill-formed입니다.
매개변수
| first, last | - | 수정할 요소의 범위를 정의하는 반복자 쌍 |
| value | - | 할당할 값 |
| policy | - | 사용할 실행 정책 |
| 형식 요구 사항 | ||
-ForwardIt는 LegacyForwardIterator의 요구 사항을 충족해야 합니다.
| ||
복잡도
정확히 std::distance(first, last)개의 할당.
예외
ExecutionPolicy라는 템플릿 매개변수가 있는 오버로드는 다음과 같이 오류를 보고합니다:
- 알고리즘의 일부로 호출된 함수의 실행이 예외를 발생시키고
ExecutionPolicy가 표준 정책 중 하나인 경우, std::terminate가 호출됩니다. 다른ExecutionPolicy의 경우 동작은 구현 정의입니다. - 알고리즘이 메모리 할당에 실패하면 std::bad_alloc이 발생합니다.
가능한 구현
| fill (1) |
|---|
template<class ForwardIt,
class T = typename std::iterator_traits<ForwardIt>::value_type>
void fill(ForwardIt first, ForwardIt last, const T& value)
{
for (; first != last; ++first)
*first = value;
}
|
참고
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_algorithm_default_value_type |
202403 |
(C++26) | 리스트 초기화 알고리즘에 대한 (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, 6, 7, 8};
println(v);
// set all of the elements to 8
std::fill(v.begin(), v.end(), 8);
println(v);
std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}};
println(nums);
#ifdef __cpp_lib_algorithm_default_value_type
std::fill(nums.begin(), nums.end(), {4, 2});
#else
std::fill(nums.begin(), nums.end(), std::complex<double>{4, 2});
#endif
println(nums);
}
출력:
0 1 2 3 4 5 6 7 8
8 8 8 8 8 8 8 8 8
(1,3) (2,2) (4,8)
(4,2) (4,2) (4,2)
결함 보고서
다음 동작 변경 결함 보고서는 이전에 발표된 C++ 표준에 소급하여 적용되었습니다.
| DR | 적용 대상 | 발표된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 283 | C++98 | T는 CopyAssignable이어야 했지만, T는 항상 쓰기 가능하지 않으므로 ForwardIt
|
대신 쓰기 가능하도록 요구됨 |
같이 보기
| 범위의 N개 요소에 주어진 값을 복사 할당합니다 (함수 템플릿 & 알고리즘 함수 객체) | |
(C++20) |
|
(C++11) |
요소의 범위를 새 위치로 복사합니다 (함수 템플릿 & 알고리즘 함수 객체) |
(C++20)(C++20) |
|
| 연속적인 함수 호출의 결과를 범위의 모든 요소에 할당합니다 (함수 템플릿 & 알고리즘 함수 객체) | |
(C++20) |
|
| 함수를 요소의 범위에 적용하고 결과를 대상 범위에 저장합니다 (함수 템플릿 & 알고리즘 함수 객체) | |
(C++20) |
|
(C++20) |
요소의 범위에 특정 값을 할당합니다 (알고리즘 함수 객체) |