KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::fill: één waarde aan een bereik toewijzen

std::fill wijst value toe aan elk element van het halfopen iteratorbereik [first, last) en retourneert in C++23 void.

Versie: C++23

Syntax

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) uit <algorithm> voert precies N toewijzingen via de iterators uit, waarbij N het aantal elementen is. value moet via de iterator schrijfbaar zijn. De overload zonder beleid is constexpr en vereist forward iterators.

Het voorbeeld vult alleen het midden van een array met 9 en print 1 9 9 4; het element bij last valt buiten het bereik. Een leeg bereik doet nul toewijzingen. Voor een geretourneerde einditerator of een heel range biedt ranges::fill een andere interface.

first en last moeten een geldig bereik met wijzigbare elementen vormen; een const-bereik kan niet worden gevuld. Zonder beleid wordt een toewijzingsexceptie doorgegeven en kunnen eerdere elementen al gewijzigd zijn. Met standaard uitvoeringsbeleid leidt een niet-afgevangen elementexceptie tot std::terminate. Als tijdelijke geheugenruimte voor parallellisatie ontbreekt, werpt de beleidsoverload in plaats daarvan std::bad_alloc.

Voorbeelden

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

Resultaat

1 9 9 4

std::fill → 1 9 9 4

Bronnen