KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::iota: vullen met opeenvolgende waarden

std::iota wijst value toe aan het eerste element en verhoogt value na elke toewijzing voor het volgende.

Versie: C++23

Syntax

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

std::iota(first,last,value) voert per element *i = value en dan ++value uit. Het starttype moet naar het iteratortype converteerbaar en pre-increment geldig zijn. Het algoritme is in C++23 constexpr en doet exact evenveel toewijzingen en verhogingen als er elementen zijn.

Het voorbeeld start bij -2 en vult vijf elementen, dus print -2 -1 0 1 2. De klassieke functie retourneert niets; std::ranges::iota retourneert einditerator en eindwaarde.

Ook na het laatste element wordt verhoogd. Een signed reeks moet ruimte laten voor dat laatste ++value, want signed overflow is ongedefinieerd; unsigned wikkelt modulo. Bij eigen typen bepaalt de operator betekenis en kosten. Het bereik moet geldig en schrijfbaar zijn; een toewijzings- of incrementexceptie wordt na een gedeeltelijk prefix doorgegeven.

Voorbeelden

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

Resultaat

-2 -1 0 1 2 

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

Bronnen