std::iota
De cppreference.com
<tbody>
</tbody> <tbody class="t-dcl-rev ">
</tbody><tbody> </tbody>| Déclaré dans l'en-tête <numeric>
|
||
template< class ForwardIt, class T > void iota( ForwardIt first, ForwardIt last, T value ); |
(depuis C++11) | |
template< class ForwardIt, class T > constexpr void iota( ForwardIt first, ForwardIt last, T value ); |
||
Remplis la plage [first, last) avec des valeurs séquenciellement croissantes, commençant par value et répétant ensuite ++value.
Opération équivalente:
*(d_first) = value;
*(d_first+1) = ++value;
*(d_first+2) = ++value;
*(d_first+3) = ++value;
...
Paramètres
| first, last | - | la plage d'éléments à remplir avec des valeurs séquenciellement croissantes commençant par value
|
| value | - | valeur initiale à placer; l'expression ++value doit être valide
|
Valeur de retour
(none)
Complexité
Exactement last - first incrémentations et assignations.
Implémentation possible
template<class ForwardIt, class T>
constexpr // depuis C++20
void iota(ForwardIt first, ForwardIt last, T value)
{
while(first != last) {
*first++ = value;
++value;
}
}
|
Notes
La fonction est nommée après la fonction entière ⍳ du language de programmation APL. C'est un des composants STL qui n'ont pas été inclus dans C++98, mais qui ont été par la suite introduits en C++11.
Exemple
L'exemple suivant applique std::shuffle à un vecteur d'itérateurs de std::list puisque std::shuffle ne peut pas être directement appliqué à std::list. std::iota est utilisé pour remplir les deux conteneurs.
#include <algorithm>
#include <iostream>
#include <list>
#include <numeric>
#include <random>
#include <vector>
int main()
{
std::list<int> l(10);
std::iota(l.begin(), l.end(), -4);
std::vector<std::list<int>::iterator> v(l.size());
std::iota(v.begin(), v.end(), l.begin());
std::shuffle(v.begin(), v.end(), std::mt19937{std::random_device{}()});
std::cout << "Contents of the list: ";
for(auto n: l) std::cout << n << ' ';
std::cout << '\n';
std::cout << "Contents of the list, shuffled: ";
for(auto i: v) std::cout << *i << ' ';
std::cout << '\n';
}
Résultat possible :
Contents of the list: -4 -3 -2 -1 0 1 2 3 4 5
Contents of the list, shuffled: 0 -1 3 4 -4 1 -2 -3 2 5
Voir aussi
attribue un ensemble d'éléments d'une certaine valeur Original: assigns a range of elements a certain value The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction générique) | |
enregistre le résultat d'une fonction dans une plage Original: saves the result of a function in a range The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction générique) | |