std::ranges::iota, std::ranges::iota_result

template< std::input_or_output_iterator O, std::sentinel_for<O> S,
          std::weakly_incrementable T >
requires std::indirectly_writable<O, const T&>
constexpr iota_result<O, T>
    iota( O first, S last, T value );

template< std::weakly_incrementable T, ranges::output_range<const T&> R >
constexpr iota_result<ranges::borrowed_iterator_t<R>, T>
    iota( R&& r, T value );

template< class O, class T >
using iota_result = ranges::out_value_result<O, T>;

Remplit la plage [first, last) avec des valeurs croissantes séquentiellement, en commençant par value et en évaluant de manière répétée ++value.

Opération équivalente :

*(first)     = value;
*(first + 1) = ++value;
*(first + 2) = ++value;
*(first + 3) = ++value;
...

Paramètres

Valeur de retour

{ dernier, valeur + ranges:: distance ( premier, dernier ) }

Complexité

Exactement last - first incréments et assignations.

Implémentation possible

struct iota_fn
{
    template<std::input_or_output_iterator O, std::sentinel_for<O> S,
            std::weakly_incrementable T>
    requires std::indirectly_writable<O, const T&>
    constexpr iota_result<O, T> operator()(O first, S last, T value) const
    {
        while (first != last)
        {
            *first = as_const(value);
            ++first;
            ++value;
        }
        return {std::move(first), std::move(value)};
    }
    template<std::weakly_incrementable T, std::ranges::output_range<const T&> R>
    constexpr iota_result<std::ranges::borrowed_iterator_t<R>, T>
    operator()(R&& r, T value) const
    {
        return (*this)(std::ranges::begin(r), std::ranges::end(r), std::move(value));
    }
};
inline constexpr iota_fn iota;

Notes

La fonction est nommée d'après la fonction entière ⍳ du langage de programmation APL .

Exemple

#include <algorithm>
#include <functional>
#include <iostream>
#include <list>
#include <numeric>
#include <random>
#include <vector>
template <typename Proj = std::identity>
void println(auto comment, std::ranges::input_range auto&& range, Proj proj = {})
{
    for (std::cout << comment; auto const &element : range)
        std::cout << proj(element) << ' ';
    std::cout << '\n';
}
int main()
{
    std::list<int> list(8);
    // Remplir la liste avec des valeurs ascendantes : 0, 1, 2, ..., 7
    std::ranges::iota(list, 0);
    println("List: ", list);
    // Un vecteur d'itérateurs (voir le commentaire de l'Exemple)
    std::vector<std::list<int>::iterator> vec(list.size());
    // Remplir avec des itérateurs vers les éléments consécutifs de la liste
    std::ranges::iota(vec.begin(), vec.end(), list.begin());
    std::ranges::shuffle(vec, std::mt19937 {std::random_device {}()});
    println("Liste vue via le vecteur: ", vec, [](auto it) { return *it; });
}

List: 0 1 2 3 4 5 6 7
List viewed via vector: 5 7 6 0 1 3 4 2

Voir aussi