Namespaces
Variants

    std::ranges::views::empty, std::ranges::empty_view

    Von de.cppreference.net
     
    C++
     
    Bereichsbibliothek
    Bereichsadaptoren
     
    Definiert in Header <ranges> 
    template<class T>
    requires std::is_object_v<T>
class empty_view : public ranges::view_interface<empty_view<T>>
    		(1) (seit C++20) 
    namespace views {
    template<class T>
    constexpr empty_view<T> empty{};
}
    		(2) (seit C++20)
    1) Eine Bereichsfabrik, die eine view ohne Elemente eines bestimmten Typs erzeugt.
    2) Variablenvorlage für empty_view.

    Memberfunktionen

    begin
    [static]
    		gibt nullptr zurück
    (öffentliche statische Elementfunktion)
    end
    [static]
    		gibt nullptr zurück
    (öffentliche statische Elementfunktion)
    data
    [static]
    		gibt nullptr zurück
    (öffentliche statische Elementfunktion)
    size
    [static]
    		gibt ​ 0 ​ zurück
    (öffentliche statische Elementfunktion)
    empty
    [static]
    		gibt true zurück
    (öffentliche statische Elementfunktion)
    Geerbt von ranges::view_interface
    (C++23)
    		 gibt einen konstanten Iterator zum Anfang der Range zurück
    (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)
    (C++23)
    		 gibt einen Sentinel für den konstanten Iterator der Range zurück
    (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)
    		gibt zurück, ob der abgeleitete View nicht leer ist, nur wenn ranges::empty darauf anwendbar ist
    (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)
    		gibt das erste Element im abgeleiteten View zurück, sofern es forward_range
    erfüllt (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)
    		gibt das letzte Element im abgeleiteten View zurück, nur wenn es bidirectional_range und common_range
    erfüllt (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)
    		gibt das nte Element im abgeleiteten View zurück, nur wenn es random_access_range
    erfüllt (öffentliche Mitgliedsfunktion von std::ranges::view_interface<D>)

    std::ranges::empty_view:: begin

    static constexpr T * begin ( ) noexcept { return nullptr ; }
    		(seit C++20)

    empty_view referenziert keine Elemente.

    std::ranges::empty_view:: end

    static constexpr T * end ( ) noexcept { return nullptr ; }
    		(seit C++20)

    empty_view referenziert keine Elemente.

    std::ranges::empty_view:: data

    static constexpr T * data ( ) noexcept { return nullptr ; }
    		(seit C++20)

    empty_view referenziert keine Elemente.

    std::ranges::empty_view:: size

    static constexpr std:: size_t size ( ) noexcept { return 0 ; }
    		(seit C++20)

    empty_view ist immer leer.

    std::ranges::empty_view:: empty

    static constexpr bool empty ( ) noexcept { return true ; }
    		(seit C++20)

    empty_view ist immer leer.

    Hilfsvorlagen

    template < class T >
    constexpr bool ranges:: enable_borrowed_range < ranges :: empty_view < T >> = true ;
    		(seit C++20)

    Diese Spezialisierung von ranges:: enable_borrowed_range bewirkt, dass empty_view die Anforderungen von borrowed_range erfüllt.

    Hinweise

    Obwohl empty_view die front -, back - und operator [ ] Memberfunktionen von view_interface erhält, führen Aufrufe dieser Funktionen stets zu undefiniertem Verhalten, da ein empty_view immer leer ist.

    Die geerbte operator bool Konvertierungsfunktion gibt immer false zurück.

    Beispiel

    Diesen Code ausführen 
    #include <ranges>
int main()
{
    namespace ranges = std::ranges;
    ranges::empty_view<long> e;
    static_assert(ranges::empty(e)); // verwendet operator bool
    static_assert(0 == e.size());
    static_assert(nullptr == e.data());
    static_assert(nullptr == e.begin());
    static_assert(nullptr == e.end());
    static_assert(nullptr == e.cbegin());
    static_assert(nullptr == e.cend());
}

    Siehe auch

    (C++17)
    		Ein Wrapper, der möglicherweise ein Objekt enthält oder nicht
    (Klassen-Template)
    (C++20)
    		Eine view die ein einzelnes Element eines bestimmten Wertes enthält
    (Klassen-Template) (Customization Point Object)
    (C++20)
    		Eine view die alle Elemente eines range enthält
    (Alias-Template) (Range-Adapter-Objekt)
    (C++20)
    		Eine view der Elemente eines anderen range
    (Klassen-Template)