WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::iota: mit fortlaufenden Werten füllen

std::iota weist dem ersten Element value zu und erhöht value nach jeder Zuweisung für das nächste Element.

Version: C++23

Syntax

template<class ForwardIt, class T>
constexpr void std::iota(ForwardIt first, ForwardIt last, T value);

std::iota(first,last,value) führt je Element *i = value und dann ++value aus. Der Starttyp muss zum Iterator-Werttyp konvertierbar und Präinkrement gültig sein. Der Algorithmus ist in C++23 constexpr und führt genau so viele Zuweisungen und Inkremente wie Elemente aus.

Das Beispiel startet bei -2 und füllt fünf Elemente, daher druckt es -2 -1 0 1 2. Die klassische Funktion liefert nichts; std::ranges::iota liefert dagegen Enditerator und Endwert.

Auch nach der letzten Zuweisung wird inkrementiert. Eine signed-Integerfolge muss Platz für dieses letzte ++value lassen, weil signed Überlauf undefiniert ist; unsigned läuft modulo um. Bei eigenen Typen bestimmt deren Inkrementoperator Bedeutung und Kosten. Der Bereich muss gültig und beschreibbar sein; Zuweisungs- oder Inkrementausnahmen werden nach teilweise gefülltem Präfix weitergereicht.

Beispiele

#include <array>
#include <iostream>
#include <numeric>

int main() {
    std::array<int, 5> values{};
    std::iota(values.begin(), values.end(), -2);
    for (int value : values) std::cout << value << ' ';
    std::cout << '\n';
}

Ergebnis

-2 -1 0 1 2 

std::iota → -2 -1 0 1 2

Quellen