Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::fill: přiřazení jedné hodnoty rozsahu

std::fill přiřadí value každému prvku polootevřeného rozsahu [first, last) a v C++23 vrací void.

Verze: C++23

Syntaxe

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> provede přes iterátory přesně N přiřazení, kde N je počet prvků. value musí být přes iterátor zapisovatelná. Přetížení bez politiky je constexpr a vyžaduje dopředné iterátory.

Příklad vyplní hodnotou 9 jen střed pole a vypíše 1 9 9 4; prvek na last je mimo rozsah. Prázdný rozsah neprovede žádné přiřazení. Potřebujete-li koncový iterátor nebo celé range, ranges::fill nabízí jiné rozhraní.

first a last musí tvořit platný rozsah s modifikovatelnými prvky; rozsah const vyplnit nelze. Bez politiky se výjimka z přiřazení šíří a předchozí prvky už mohou být změněny. Se standardní politikou vede nezachycená výjimka z operace nad prvkem k std::terminate. Není-li dostupná dočasná paměť potřebná pro paralelizaci, přetížení s politikou místo toho vyhodí std::bad_alloc.

Příklady

#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';
}

Výsledek

1 9 9 4

std::fill → 1 9 9 4

Zdroje