std::ranges::views::iota, std::ranges::iota_view

 

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

 

Bereichsbibliothek

Bereichszugriff begin cbegin   end cend rbegin crbegin   rend crend size ssize   data cdata reserve_hint (C++26)   empty

Range-Konvertierungen std::from_range_t std::from_range (C++23)(C++23)     to (C++23)

Behandlung von hängenden Iteratoren dangling borrowed_iterator_t borrowed_subrange_t

Range-Primitive
range_size_trange_difference_trange_value_t elements_of (C++23)	iterator_tconst_iterator_tsentinel_tconst_sentinel_t (C++23)(C++23)	range_reference_trange_const_reference_trange_rvalue_reference_trange_common_reference_t (C++23)

Range-Konzepte
range borrowed_range    common_range	sized_range viewable_range    view	input_range output_range forward_range	bidirectional_range    random_access_range contiguous_range	approximately_sized_range (C++26) constant_range (C++23)

Ansichten
view_interface	subrange

Range-Fabriken
empty_viewviews::empty	single_viewviews::single	basic_istream_viewviews::istream	iota_viewviews::iota	repeat_viewviews::repeat (C++23)(C++23)

Range-Adaptoren
views::all_tviews::all as_rvalue_viewviews::as_rvalue (C++23)(C++23)   filter_viewviews::filter transform_viewviews::transform take_viewviews::take take_while_viewviews::take_while common_viewviews::common views::counted to_input_viewviews::to_input (C++26)(C++26)	ref_view drop_viewviews::drop drop_while_viewviews::drop_while lazy_split_viewviews::lazy_split split_viewviews::split join_viewviews::join join_with_viewviews::join_with (C++23)(C++23)   concat_viewviews::concat (C++26)(C++26) cache_latest_viewviews::cache_latest (C++26)(C++26)	owning_view reverse_viewviews::reverse as_const_viewviews::as_const (C++23)(C++23) elements_viewviews::elements keys_viewviews::keys values_viewviews::values enumerate_viewviews::enumerate (C++23)(C++23) zip_viewviews::zip (C++23)(C++23) zip_transform_viewviews::zip_transform (C++23)(C++23)	adjacent_viewviews::adjacent (C++23)(C++23) views::pairwise (C++23) adjacent_transform_viewviews::adjacent_transform (C++23)(C++23) views::pairwise_transform (C++23) chunk_viewviews::chunk (C++23)(C++23) slide_viewviews::slide (C++23)(C++23) chunk_by_viewviews::chunk_by (C++23)(C++23) stride_viewviews::stride (C++23)(C++23) cartesian_product_viewviews::cartesian_product (C++23)(C++23)

Range generators std::generator (C++23)

Range-Adaptor-Closure-Objekte range_adaptor_closure (C++23)

Range-Adaptor-Objekte

Hilfselemente
copyable-box movable-box (bis C++23)  (C++23)	simple-view non-propagating-cache

 

std::ranges::iota_view

Memberfunktionen

iota_view::iota_view

iota_view::begin

iota_view::end

iota_view::empty

iota_view::size

Deduction Guides

Verschachtelte Klassen

Iterator

Hilfskonzepte

decrementable

advanceable

Membertypen

Memberfunktionen

iota_view::iterator::iterator

iota_view::iterator::operator*

iota_view::iterator::operator[]

iota_view::iterator::operator++ iota_view::iterator::operator++(int)

iota_view::iterator::operator-- iota_view::iterator::operator--(int)

iota_view::iterator::operator+=

iota_view::iterator::operator-=

Nicht-Member-Funktionen

operator==(iota_view::iterator) operator<(iota_view::iterator) operator>(iota_view::iterator) operator<=(iota_view::iterator) operator>=(iota_view::iterator) operator<=>(iota_view::iterator)

operator+(iota_view::iterator)

operator-(iota_view::iterator)

Sentinel

Memberfunktionen

iota_view::sentinel::sentinel

Nicht-Member-Funktionen

operator==(iota_view::iterator,iota_view::sentinel)

operator-(iota_view::iterator,iota_view::sentinel)

 

Definiert in der Header-Datei <ranges>
template< std::weakly_incrementable W,           std::semiregular Bound = std::unreachable_sentinel_t >     requires /*weakly-equality-comparable-with*/<W, Bound> && std::copyable<W> class iota_view     : public ranges::view_interface<iota_view<W, Bound>>	(1)	(seit C++20)
namespace views {     inline constexpr /* unspecified */ iota = /* unspecified */; }	(2)	(seit C++20)
Aufruf-Signatur
template< class W >     requires /* siehe unten */ constexpr /* siehe unten */ iota( W&& value );		(seit C++20)
template< class W, class Bound >     requires /* siehe unten */ constexpr /* siehe unten */ iota( W&& value, Bound&& bound );		(seit C++20)

1) Ein Range-Factory, die eine Folge von Elementen durch wiederholtes Inkrementieren eines Anfangswerts erzeugt. Kann entweder begrenzt oder unbegrenzt (unendlich) sein.

2) views::iota(e) und views::iota(e, f) sind ausdrucksäquivalent zu iota_view<std::decay_t<decltype((e))>>(e) und iota_view(e, f) bzw. für alle geeigneten Teil-Ausdrücke e und f.

Customization Point Objects

Der Name views::iota bezeichnet ein Customization Point Object, welches ein const Function Object eines literalen semiregular-Klassentyps ist. Zu Aus exposiçãozwecken wird die cv-unqualified-Version seines Typs als __iota_fn bezeichnet.

Alle Instanzen von __iota_fn sind gleich. Die Effekte des Aufrufs verschiedener Instanzen des Typs __iota_fn mit denselben Argumenten sind äquivalent, unabhängig davon, ob der die Instanz bezeichnende Ausdruck ein lvalue oder ein rvalue ist, und ob er const-qualifiziert ist oder nicht (jedoch ist eine volatile-qualifizierte Instanz nicht zwingend aufrufbar). Somit kann views::iota frei kopiert werden und seine Kopien können austauschbar verwendet werden.

Gegeben eine Menge von Typen Args..., wenn std::declval<Args>()... die Anforderungen für Argumente an views::iota oben erfüllen, dann modelliert __iota_fn

• std::invocable<__iota_fn, Args...>,
• std::invocable<const __iota_fn, Args...>,
• std::invocable<__iota_fn&, Args...>, und
• std::invocable<const __iota_fn&, Args...>.
  

Andernfalls nimmt kein Funktionsaufrufoperator von __iota_fn an der Überladungsauflösung teil.

Datenmember

Mitglied	Definition
W value_	Der Anfangswert ((exposition-only member object*)
Bound bound_	Der Sentinel-Wert, kann unerreichbar sein ((exposition-only member object*)

Member-Funktionen

(Konstruktor)	Erzeugt eine iota_view (öffentliche Memberfunktion)
begin	Ermittelt den Anfangs-Iterator einer iota_view (öffentliche Memberfunktion)
end	Ermittelt den Sentinel, der das Ende einer iota_view kennzeichnet (öffentliche Memberfunktion)
empty	Prüft, ob die iota_view leer ist (d.h. ob Iterator und Sentinel gleich verglichen werden) (öffentliche Memberfunktion)
size (optional)	Ermittelt die Größe einer iota_view (nur bereitgestellt, wenn sie begrenzt ist) (öffentliche Memberfunktion)
Geerbt von std::ranges::view_interface
cbegin (C++23)	gibt einen konstanten Iterator zum Anfang des Bereichs zurück (public member function of std::ranges::view_interface<D>)
cend (C++23)	gibt ein Sentinel für den konstanten Iterator des Bereichs zurück (public member function of std::ranges::view_interface<D>)
operator bool	gibt zurück, ob die abgeleitete Ansicht nicht leer ist, bereitgestellt nur, wenn ranges::empty darauf anwendbar ist (public member function of std::ranges::view_interface<D>)
front	gibt das erste Element in der abgeleiteten View zurück, bereitgestellt, wenn sie forward_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)
back	gibt das letzte Element in der abgeleiteten View zurück, nur bereitgestellt, wenn sie bidirectional_range und common_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)
operator[]	gibt das n-te Element in der abgeleiteten View zurück, nur bereitgestellt, wenn sie random_access_range erfüllt (öffentliche Member-Funktion von std::ranges::view_interface<D>)

Verschachtelte Klassen

iterator	der Iterator-Typ ((nur zur Veranschaulichung)*)
sentinel	Der Sentinel-Typ, der verwendet wird, wenn die iota_view begrenzt ist und Bound und W nicht denselben Typ haben ((nur zur Veranschaulichung)*)

Hilfs-Templates

template< std::weakly_incrementable W, std::semiregular Bound > constexpr bool ranges::enable_borrowed_range<ranges::iota_view<W, Bound>> = true;		(seit C++20)

Diese Spezialisierung von ranges::enable_borrowed_range lässt iota_view borrowed_range erfüllen.

Beispiel

Führen Sie diesen Code aus

#include <algorithm>
#include <iostream>
#include <ranges>
 
struct Bound
{
    int bound;
    bool operator==(int x) const { return x == bound; }
};
 
int main()
{
    for (int i : std::ranges::iota_view{1, 10})
        std::cout << i << ' ';
    std::cout << '\n';
 
    for (int i : std::views::iota(1, 10))
        std::cout << i << ' ';
    std::cout << '\n';
 
    for (int i : std::views::iota(1, Bound{10}))
        std::cout << i << ' ';
    std::cout << '\n';
 
    for (int i : std::views::iota(1) | std::views::take(9))
        std::cout << i << ' ';
    std::cout << '\n';
 
    std::ranges::for_each(std::views::iota(1, 10),
                          [](int i){ std::cout << i << ' '; });
    std::cout << '\n';
}

Ausgabe

1 2 3 4 5 6 7 8 9
1 2 3 4 5 6 7 8 9
1 2 3 4 5 6 7 8 9
1 2 3 4 5 6 7 8 9
1 2 3 4 5 6 7 8 9

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 4096	C++20	views::iota könnte eine iota_view as-is kopieren	verbieten
P2325R3	C++20	iota_view erforderte, dass W semiregular ist da view default_initializable erfordert	erfordert nur, dass W copyable ist

Siehe auch

iota (C++11)	füllt einen Bereich mit sukzessiven Inkrementen des Startwerts (Funktionstemplate)
ranges::iota (C++23)	füllt einen Bereich mit sukzessiven Inkrementen des Startwerts (Funktionsobjekt für Algorithmen)
ranges::repeat_viewviews::repeat (C++23)	ein view, der eine Sequenz aus der wiederholten Erzeugung desselben Werts besteht (Klassen-Template) (Customization Point Objekt)