begin
Ruft einen Iterator für das erste Element in einem angegebenen Container ab.
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]);
Parameter
cont
Ein Container.array
Ein Array von Objekten des Typs Ty.
Rückgabewert
Die ersten beiden Vorlagenfunktionen geben cont.begin() zurück. Die erste Funktion ist nicht konstant; die zweite ist konstant.
Die dritte Vorlagenfunktion gibt array zurück.
Beispiel
Es empfiehlt sich, diese Vorlagenfunktion anstelle des Containermembers begin() zu verwenden, wenn ein eher generisches Verhalten erforderlich ist.
// 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
Die Funktion reverse_sort unterstützt Container jeder Art, neben den normalen Arrays, da sie die Nichtmemberversion von begin() aufruft. Wenn reverse_sort zur Verwendung des Containermembers begin() codiert wurde:
template <typename C> void reverse_sort(C& c) {
using std::begin;
using std::end;
std::sort(c.begin(), c.end(), std::greater<>());
}
Das Senden eines Arrays würde in diesem Fall folgenden Compilerfehler verursachen:
error C2228: left of '.begin' must have class/struct/union
Anforderungen
Header: <Iterator>
Namespace: std