std::end, std::cend

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Iterator-Bibliothek

Iterator-Konzepte
indirectly_readable (C++20) indirectly_writable (C++20) weakly_incrementable (C++20) incrementable (C++20) is-integer-like is-signed-integer-like (C++20)(C++20)	sentinel_for (C++20) sized_sentinel_for (C++20) input_iterator (C++20) output_iterator (C++20) input_or_output_iterator (C++20)	forward_iterator (C++20) bidirectional_iterator (C++20) random_access_iterator (C++20) contiguous_iterator (C++20)
Iterator-Primitive
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tagcontiguous_iterator_tag (C++20)	iter_value_titer_difference_titer_reference_titer_const_reference_titer_rvalue_reference_titer_common_reference_t (C++20)(C++20)(C++20)(C++23)(C++20)(C++20)	iterator (veraltet in C++17) iterator_traits incrementable_traits (C++20) indirectly_readable_traits (C++20)
Algorithmus-Konzepte und Hilfsprogramme
Indirekte aufrufbare Konzepte
indirectly_unary_invocableindirectly_regular_unary_invocable (C++20)(C++20)	indirect_unary_predicate (C++20) indirect_binary_predicate (C++20)	indirect_equivalence_relation (C++20) indirect_strict_weak_order (C++20)
Gemeinsame Algorithmus-Anforderungen
indirectly_movable (C++20) indirectly_movable_storable (C++20) indirectly_copyable (C++20)	indirectly_copyable_storable (C++20)   indirectly_swappable (C++20) indirectly_comparable (C++20)	permutable (C++20) mergeable (C++20) sortable (C++20)
Dienstprogramme
indirect_result_t (C++20)	projected (C++20)	projected_value_t (C++26)
Iterator-Adapter
reverse_iterator make_reverse_iterator (C++14) move_iterator (C++11) make_move_iterator (C++11) default_sentinel_tdefault_sentinel (C++20)(C++20) unreachable_sentinel_tunreachable_sentinel (C++20)(C++20)	front_insert_iterator back_insert_iterator inserter insert_iterator front_inserter back_inserter move_sentinel (C++20)	common_iterator (C++20) counted_iterator (C++20) basic_const_iterator (C++23) const_iterator (C++23) const_sentinel (C++23) make_const_iterator (C++23) make_const_sentinel (C++23)
Stream-Iteratoren istream_iterator    ostream_iterator istreambuf_iterator ostreambuf_iterator	Iterator-Anpassungspunkte ranges::iter_move (C++20) ranges::iter_swap (C++20)
Iterator-Operationen advance distance prev (C++11)   next (C++11) ranges::advance (C++20) ranges::distance (C++20) ranges::prev (C++20) ranges::next (C++20)	Bereichszugriff begincbegin (C++11)(C++14) rbegincrbegin (C++14)(C++14)   endcend (C++11)(C++14) rendcrend (C++14)(C++14)   sizessize (C++17)(C++20) empty (C++17) data (C++17)

 

Definiert in der Header-Datei <array>
Definiert in Header <deque>
Definiert in Header <flat_map>
Definiert in Header <flat_set>
Definiert in Header <forward_list>
Definiert in Header <inplace_vector>
Definiert in Header <iterator>
Definiert in Header <list>
Definiert in Header <map>
Definiert in Header <regex>
Definiert in Header <set>
Definiert in Header <span>
Definiert in Header <string>
Definiert in Header <string_view>
Definiert in Header <unordered_map>
Definiert in Header <unordered_set>
Definiert in Header <vector>
template< class C > auto end( C& c ) -> decltype(c.end());	(1)	(seit C++11) (constexpr seit C++17)
template< class C > auto end( const C& c ) -> decltype(c.end());	(2)	(seit C++11) (constexpr seit C++17)
template< class T, std::size_t N > T* end( T (&array)[N] );	(3)	(seit C++11) (noexcept seit C++14) (constexpr seit C++14)
template< class C > constexpr auto cend( const C& c ) noexcept(/* siehe unten */)     -> decltype(std::end(c));	(4)	(seit C++14)

Gibt einen Iterator zum Ende (d.h. zum Element nach dem letzten Element) des gegebenen Bereichs zurück.

1,2) Gibt c.end() zurück, was typischerweise ein Iterator ist, der eins hinter dem Ende der von c repräsentierten Sequenz liegt.

1) Wenn C ein standardmäßiger Container ist, wird ein C::iterator Objekt zurückgegeben.

2) Wenn C ein standardmäßiger Container ist, wird ein C::const_iterator Objekt zurückgegeben.

3) Gibt einen Zeiger auf das Ende von array zurück.

4) Gibt std::end(c) zurück, wobei c immer als const-qualifiziert behandelt wird.

Wenn C ein standardmäßiger Container ist, wird ein C::const_iterator Objekt zurückgegeben.

Parameter

c	-	ein Container oder eine Ansicht mit einer Memberfunktion end
array	-	Ein Array beliebigen Typs

Rückgabewert

1,2) c.end()

3) array + N

4) c.end()

Exceptions

4)

noexcept-Spezifikation:  

noexcept(noexcept(std::end(c)))

Überladungen

Benutzerdefinierte Überladungen von end können für Klassen und Aufzählungstypen bereitgestellt werden, die keine geeignete end() Memberfunktion bereitstellen, aber dennoch iterierbar sind. Die folgenden Überladungen werden bereits von der Standardbibliothek bereitgestellt

std::end(std::initializer_list) (C++11)	spezialisiert std::end (function template)
std::end(std::valarray) (C++11)	spezialisiert std::end (function template)
begin(std::filesystem::directory_iterator)end(std::filesystem::directory_iterator) (C++17)	Unterstützung für range-basierte for-Schleifen (Funktion)
begin(std::filesystem::recursive_directory_iterator)end(std::filesystem::recursive_directory_iterator)	Unterstützung für range-basierte for-Schleifen (Funktion)

Ähnlich der Verwendung von swap (beschrieben in Swappable) ist die typische Verwendung der end-Funktion in einem generischen Kontext äquivalent zu using std::end; end(arg);, was sowohl den mittels ADL ausgewählten Überladungen für benutzerdefinierte Typen als auch den Standardbibliotheks-Funktionstemplates ermöglicht, im selben Überladungsraum zu erscheinen.

template<typename Container, typename Function>
void for_each(Container&& cont, Function f)
{
    using std::begin;
    auto it = begin(cont);
    using std::end;
    auto end_it = end(cont);
 
    for (; it != end_it; ++it)
        f(*it);
}

Überladungen von end, die durch argumentabhängige Suche gefunden werden, können verwendet werden, um das Verhalten von std::ranges::end, std::ranges::cend und anderen Anpassungszeigerobjekten, die von std::ranges::end abhängen, anzupassen.

(seit C++20)

Anmerkungen

Die Nicht-Array-Überladungen spiegeln exakt das Verhalten von C::end() wider. Ihre Auswirkungen können überraschend sein, wenn die Memberfunktion keine sinnvolle Implementierung hat.

std::cend wurde zur Vereinheitlichung von Member- und Nicht-Member-Bereichszugriffen eingeführt. Siehe auch LWG issue 2128.

Wenn C eine shallow-const Ansicht ist, kann std::cend einen veränderlichen Iterator zurückgeben. Dieses Verhalten ist für einige Benutzer unerwartet. Siehe auch P2276 und P2278.

Beispiel

Führen Sie diesen Code aus

#include <algorithm>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> v = {3, 1, 4};
    if (std::find(std::begin(v), std::end(v), 5) != std::end(v))
        std::cout << "Found a 5 in vector v!\n";
 
    int w[] = {5, 10, 15};
    if (std::find(std::begin(w), std::end(w), 5) != std::end(w))
        std::cout << "Found a 5 in array w!\n";
}

Ausgabe

Found a 5 in array w!

Siehe auch

begincbegin (C++11)(C++14)	gibt einen Iterator zum Anfang eines Containers oder Arrays zurück (Funktionsvorlage)
ranges::end (C++20)	gibt ein Sentinel zurück, das das Ende eines Ranges anzeigt (Customization Point Objekt)
ranges::cend (C++20)	gibt ein Sentinel zurück, das das Ende eines schreibgeschützten Ranges anzeigt (Customization Point Objekt)