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