Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::iota : remplir par valeurs successives

std::iota affecte value au premier élément puis incrémente value après chaque affectation pour le suivant.

Version : C++23

Syntaxe

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

std::iota(first,last,value) exécute *i = value puis ++value pour chaque élément. Le type initial doit être convertible vers le type de valeur et la pré-incrémentation bien formée. L’algorithme est constexpr en C++23 et effectue exactement autant d’affectations et d’incréments que d’éléments.

L’exemple part de -2 et remplit cinq éléments, donc affiche -2 -1 0 1 2. La fonction classique ne renvoie rien ; std::ranges::iota renvoie l’itérateur et la valeur finaux.

L’incrément a aussi lieu après la dernière affectation. Une suite signed doit donc laisser de la place au dernier ++value, car le débordement signé est indéfini ; unsigned boucle modulo. Pour un type utilisateur, son opérateur fixe sens et coût. La plage doit être valide et inscriptible ; toute exception d’affectation ou d’incrément se propage après un préfixe partiellement rempli.

Exemples

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

Résultat

-2 -1 0 1 2 

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

Sources