Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::iota: preencher com valores sucessivos

std::iota atribui value ao primeiro elemento e incrementa value após cada atribuição para o seguinte.

Versão: C++23

Sintaxe

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

std::iota(first,last,value) executa *i = value e depois ++value por elemento. O tipo inicial tem de converter para o value type e o pré-incremento ser válido. É constexpr em C++23 e faz exatamente tantas atribuições e incrementos quantos os elementos.

O exemplo começa em -2 e preenche cinco elementos, imprimindo -2 -1 0 1 2. A função clássica não devolve valor; std::ranges::iota devolve iterador e valor finais.

Há incremento também após a última atribuição. Uma sequência signed deve deixar espaço para o último ++value, pois overflow signed é undefined behavior; unsigned dá a volta módulo. Em tipos próprios o operador define sentido e custo. O intervalo tem de ser válido e gravável; exceção de atribuição ou incremento propaga-se após um prefixo parcial.

Exemplos

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

Resultado

-2 -1 0 1 2 

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

Fontes