Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::iota: wypełnianie kolejnymi wartościami

std::iota przypisuje value do pierwszego elementu, potem zwiększa value przed każdym kolejnym przypisaniem.

Wersja: C++23

Składnia

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

std::iota(first,last,value) dla każdego elementu wykonuje *i = value, a następnie ++value. Typ początkowy musi być konwertowalny do typu wartości iteratora, a preinkrementacja musi być poprawna. Algorytm jest constexpr w C++23 i wykonuje dokładnie tyle przypisań i inkrementacji, ile jest elementów.

Przykład zaczyna od -2 i wypełnia pięcioelementową tablicę, dlatego wypisuje -2 -1 0 1 2. Funkcja niczego nie zwraca; klasyczne std::iota różni się od std::ranges::iota, które zwraca końcowy iterator i końcową wartość.

Inkrementacja następuje także po przypisaniu ostatniego elementu. Dla signed integer zakres nie może więc doprowadzić ++value do przepełnienia, bo byłoby to undefined behavior; typ bez znaku zawija modulo. Dla własnego typu znaczenie i koszt ++value określa jego operator. Zakres musi być prawidłowy i zapisywalny, a wyjątek przypisania lub inkrementacji propaguje się po częściowym wypełnieniu.

Przykłady

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

Wynik

-2 -1 0 1 2 

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

Źródła