WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::fill: einem Bereich einen Wert zuweisen

std::fill weist jedem Element des halboffenen Iteratorbereichs [first, last) value zu und liefert in C++23 void.

Version: 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) aus <algorithm> führt genau N Zuweisungen über die Bereichsiteratoren aus, wobei N die Elementzahl ist. value muss durch den Iterator schreibbar sein. Der Overload ohne Richtlinie ist constexpr und verlangt Vorwärtsiteratoren.

Das Beispiel füllt nur die Mitte eines Arrays mit 9 und gibt 1 9 9 4 aus; das Element bei last gehört nicht zum Bereich. Ein leerer Bereich führt keine Zuweisung aus. Für einen zurückgegebenen Iterator oder einen ganzen Range bietet ranges::fill eine andere Schnittstelle.

first und last müssen einen gültigen Bereich bilden, dessen Elemente schreibbar sind; ein const-Bereich ist nicht füllbar. Eine Zuweisungsausnahme ohne Richtlinie wird weitergereicht, wobei frühere Elemente schon geändert sein können. Mit Standard-Ausführungsrichtlinie führt eine unbehandelte Elementausnahme zu std::terminate. Fehlt der für die Parallelisierung benötigte temporäre Speicher, löst die Richtlinienüberladung stattdessen std::bad_alloc aus.

Beispiele

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

Ergebnis

1 9 9 4

std::fill → 1 9 9 4

Quellen