Namespaces
Variants

    std::ranges::cend

    Von de.cppreference.net
     
    C++
     
    Ranges-Bibliothek
    Range-Adapter
     
    Definiert in Header <ranges>
    Definiert in Header <iterator> 
    inline namespace /* unspecified */ {
    inline constexpr /* unspecified */ cend = /* unspecified */;
}
    		(seit C++20)
    (Customization-Point-Objekt)
    Aufrufsignatur
    		 
    template< class T >
    requires /* see below */
constexpr /* see below */ auto cend( T&& t );
    		(seit C++20)

    Gibt einen Sentinel für den konstanten Iterator(seit C++23) zurück, der das Ende eines const-qualifizierten(bis C++23) Bereichs anzeigt.

    Sei CT

    • const std::remove_reference_t<T>&wenn das Argument ein Lvalue ist (d.h. T ein Lvalue-Referenztyp ist),
    • const T andernfalls.

    Ein Aufruf von ranges::cend ist ausdrucksäquivalent zu ranges::end(static_cast<CT&&>(t)).

    		(bis C++23)

    Wenn das Argument ein Lvalue ist oder ranges::enable_borrowed_range<std::remove_cv_t<T>> true ist, dann ist ein Aufruf von ranges::cend ausdrucksäquivalent zu:

    • std::const_sentinel<decltype(U)>(U) für einen Ausdruck U äquivalent zu ranges::end(possibly-const-range(t)).

    In allen anderen Fällen ist ein Aufruf von ranges::cend fehlerhaft (ill-formed), was zu Substitutionsfehlern führen kann, wenn der Aufruf im unmittelbaren Kontext einer Template-Instantiierung erscheint.

    		(seit C++23)

    Wenn ranges::cend(e) für einen Ausdruck e gültig ist, wobei decltype((e)) T ist, dann modelliert CT std::ranges::range, und(bis C++23) std::sentinel_for<S, I> ist true in allen Fällen, wobei S decltype(ranges::cend(e)) ist und I decltype(ranges::cbegin(e)) ist. Zusätzlich modelliert S constant-iterator wenn es input_iterator modelliert.(seit C++23)

    Customization Point Objects

    Der Name ranges::cend bezeichnet ein Customization Point Object , welches ein konstantes Function Object eines Literal semiregular -Klassentyps ist. Weitere Details finden Sie unter CustomizationPointObject .

    Beispiel

    Diesen Code ausführen 
    #include <algorithm>
#include <cassert>
#include <ranges>
#include <vector>
int main()
{
    std::vector vec{3, 1, 4};
    int arr[]{5, 10, 15};
    assert(std::ranges::find(vec, 5) == std::ranges::cend(vec));
    assert(std::ranges::find(arr, 5) != std::ranges::cend(arr));
}

    Siehe auch

    (C++20)
    		gibt einen Sentinel zurück, der das Ende eines Bereichs anzeigt
    (Anpassungspunktobjekt)
    (C++11) (C++14)
    		gibt einen Iterator zum Ende eines Containers oder Arrays zurück
    (Funktionstemplate)