Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::fill: przypisanie jednej wartości do zakresu

std::fill przypisuje value do każdego elementu półotwartego zakresu iteratorów [first, last) i w C++23 zwraca void.

Wersja: C++23

Składnia

template<class ForwardIterator, class T>
constexpr void std::fill(
    ForwardIterator first, ForwardIterator last, const T& value);

template<class ExecutionPolicy, class ForwardIterator, class T>
void std::fill(ExecutionPolicy&& exec,
    ForwardIterator first, ForwardIterator last, const T& value);

std::fill(first, last, value) z <algorithm> wykonuje dokładnie N przypisań przez kolejne iteratory zakresu, gdzie N jest jego liczbą elementów. value musi dać się zapisać przez iterator. Przeciążenie bez polityki jest constexpr i wymaga iteratorów postępujących.

Przykład wypełnia tylko środkową część tablicy wartością 9 i drukuje 1 9 9 4; element pod last nie należy do zakresu. Pusty zakres wykonuje zero przypisań. Jeśli potrzebujesz zwracanego iteratora albo całego range, ranges::fill ma inny interfejs.

first i last muszą opisywać poprawny zakres, a elementy muszą być modyfikowalne; const zakresu nie da się wypełnić. Wyjątek z przypisania w wersji bez polityki jest propagowany i wcześniejsze elementy mogą już być zmienione. Przy standardowej polityce wykonania nieprzechwycony wyjątek operacji na elemencie wywołuje std::terminate. Jeśli zabraknie pamięci tymczasowej potrzebnej do równoległego wykonania, przeciążenie z polityką zamiast tego rzuca std::bad_alloc.

Przykłady

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    std::array values{1, 2, 3, 4};
    std::fill(values.begin() + 1, values.end() - 1, 9);
    std::cout << values[0] << ' ' << values[1] << ' '
              << values[2] << ' ' << values[3] << '\n';
}

Wynik

1 9 9 4

std::fill → 1 9 9 4

Źródła