begin
Récupère un itérateur sur le premier élément d'un conteneur spécifié.
template<class Container>
auto begin(Container& cont)
-> decltype(cont.begin());
template<class Container>
auto begin(const Container& cont)
-> decltype(cont.begin());
template<class Ty, class Size>
Ty *begin(Ty (&array)[Size]);
Paramètres
cont
Conteneur.array
Tableau d'objets de type Ty.
Valeur de retour
Les deux premières fonctions de modèle retournent cont.begin(). La première fonction est non constante ; la seconde est constante.
La troisième fonction de modèle retourne array.
Exemple
Nous vous recommandons d'utiliser cette fonction de modèle à la place du membre de conteneur begin() lorsqu'un comportement plus générique est requis.
// cl.exe /EHsc /nologo /W4 /MTd
#include <algorithm>
#include <functional>
#include <iostream>
#include <iterator>
#include <vector>
template <typename C> void reverse_sort(C& c) {
using std::begin;
using std::end;
std::sort(begin(c), end(c), std::greater<>());
}
template <typename C> void print(const C& c) {
for (const auto& e : c) {
std::cout << e << " ";
}
std::cout << "\n";
}
int main() {
std::vector<int> v = { 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1 };
print(v);
reverse_sort(v);
print(v);
std::cout << "--\n";
int arr[] = { 23, 70, 35, 106, 53, 160, 80, 40, 20, 10, 5, 16, 8, 4, 2, 1 };
print(arr);
reverse_sort(arr);
print(arr);
}
Output:
11 34 17 52 26 13 40 20 10 5 16 8 4 2 1
52 40 34 26 20 17 16 13 11 10 8 5 4 2 1
--
23 70 35 106 53 160 80 40 20 10 5 16 8 4 2 1
160 106 80 70 53 40 35 23 20 16 10 8 5 4 2 1
La fonction reverse_sort prend en charge des conteneurs de tout type, outre les tableaux standard, car elle appelle la version non-membre de begin(). Si reverse_sort était codée pour utiliser le membre de conteneur begin() :
template <typename C> void reverse_sort(C& c) {
using std::begin;
using std::end;
std::sort(c.begin(), c.end(), std::greater<>());
}
Ensuite, l'envoi d'un tableau à cette fonction générerait l'erreur du compilateur suivante :
error C2228: left of '.begin' must have class/struct/union
Configuration requise
En-tête : <iterator>
Espace de noms : std