Namespaces
Variants

std::fill

cppreference.net에서
 
 
알고리즘 라이브러리
제약된 알고리즘 및 범위에 대한 알고리즘 (C++20)
제약된 알고리즘, 예: ranges::copy, ranges::sort, ...
정렬 및 관련 연산
분할 연산
(C++11)    

정렬 연산
이진 검색 연산
(on partitioned ranges)
집합 연산 (on sorted ranges)
병합 연산 (on sorted ranges)
힙 연산
최소/최대 연산
(C++11)
(C++17)
사전식 비교 연산
순열 연산


 
헤더에 정의됨 <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:

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>>

(until C++20)

std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>>

(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개 요소에 주어진 값을 복사 할당합니다
(함수 템플릿 & 알고리즘 함수 객체)
요소의 범위를 새 위치로 복사합니다
(함수 템플릿 & 알고리즘 함수 객체)
연속적인 함수 호출의 결과를 범위의 모든 요소에 할당합니다
(함수 템플릿 & 알고리즘 함수 객체)
함수를 요소의 범위에 적용하고 결과를 대상 범위에 저장합니다
(함수 템플릿 & 알고리즘 함수 객체)
요소의 범위에 특정 값을 할당합니다
(알고리즘 함수 객체)