Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::iota: riempire con valori successivi

std::iota assegna value al primo elemento e incrementa value dopo ogni assegnazione per il successivo.

Versione: C++23

Sintassi

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

std::iota(first,last,value) esegue *i = value e poi ++value per elemento. Il tipo iniziale deve convertirsi al value type e il preincremento essere valido. È constexpr in C++23 ed esegue esattamente tante assegnazioni e incrementi quanti sono gli elementi.

L’esempio parte da -2 e riempie cinque elementi, quindi stampa -2 -1 0 1 2. La funzione classica non restituisce nulla; std::ranges::iota restituisce iteratore e valore finali.

Incrementa anche dopo l’ultima assegnazione. Una sequenza signed deve lasciare spazio per l’ultimo ++value, perché l’overflow signed è comportamento indefinito; unsigned avvolge modulo. Per tipi propri l’operatore determina significato e costo. Il range deve essere valido e scrivibile; eccezioni di assegnazione o incremento si propagano dopo un prefisso parziale.

Esempi

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

Risultato

-2 -1 0 1 2 

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

Fonti