std::from_range, std::from_range_t

 

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

 

Definiert in der Header-Datei <ranges>
struct from_range_t { explicit from_range_t() = default; };		(seit C++23)
inline constexpr std::from_range_t from_range {};		(seit C++23)

std::from_range ist ein Tag zur Disambiguierung, der an die Konstruktoren der geeigneten Container übergeben werden kann, um anzugeben, dass das enthaltene Element aus einem Bereich konstruiert wird.

Der entsprechende Typ std::from_range_t kann in der Parameterliste des Konstruktors verwendet werden, um auf den beabsichtigten Tag zu matchen.

Standardbibliothek

Die folgenden Typen der Standardbibliothek verwenden den Typ std::from_range_t in ihren Konstruktoren

Container-Bibliothek
(Konstruktor) (C++23)	konstruiert den vector aus einem Bereich (public member function of std::vector<T,Allocator>)
(Konstruktor) (C++26)	konstruiert den inplace_vector aus einem Bereich (public member function of std::inplace_vector<T,N>)
(Konstruktor) (C++23)	konstruiert den deque aus einem Bereich (public member function of std::deque<T,Allocator>)
(Konstruktor) (C++23)	konstruiert die forward_list aus einem Bereich (public member function of std::forward_list<T,Allocator>)
(Konstruktor) (C++23)	konstruiert die list aus einem Bereich (public member function of std::list<T,Allocator>)
(Konstruktor) (C++23)	konstruiert das set aus einem Bereich (public member function of std::set<Key,Compare,Allocator>)
(Konstruktor) (C++23)	konstruiert die map aus einem Bereich (public member function of std::map<Key,T,Compare,Allocator>)
(Konstruktor) (C++23)	konstruiert das multiset aus einem Bereich (public member function of std::multiset<Key,Compare,Allocator>)
(Konstruktor) (C++23)	konstruiert die multimap aus einem Bereich (public member function of std::multimap<Key,T,Compare,Allocator>)
(Konstruktor) (C++23)	konstruiert das unordered_set aus einem Bereich (public member function of std::unordered_set<Key,Hash,KeyEqual,Allocator>)
(Konstruktor) (C++23)	konstruiert die unordered_map aus einem Bereich (public member function of std::unordered_map<Key,T,Hash,KeyEqual,Allocator>)
(Konstruktor) (C++23)	konstruiert das unordered_multiset aus einem Bereich (public member function of std::unordered_multiset<Key,Hash,KeyEqual,Allocator>)
(Konstruktor) (C++23)	konstruiert die unordered_multimap aus einem Bereich (public member function of std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>)
(Konstruktor) (C++23)	konstruiert die priority_queue aus einem Bereich (public member function of std::priority_queue<T,Container,Compare>)
(Konstruktor) (C++23)	konstruiert die queue aus einem Bereich (public member function of std::queue<T,Container>)
(Konstruktor) (C++23)	konstruiert die stack aus einem Bereich (public member function of std::stack<T,Container>)
(Konstruktor) (C++23)	konstruiert das flat_set aus einem Bereich (public member function of std::flat_set<Key,Compare,KeyContainer>)
(Konstruktor) (C++23)	konstruiert die flat_map aus einem Bereich (public member function of std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>)
(Konstruktor) (C++23)	konstruiert das flat_multiset aus einem Bereich (public member function of std::flat_multiset<Key,Compare,KeyContainer>)
(Konstruktor) (C++23)	konstruiert die flat_multimap aus einem Bereich (public member function of std::flat_multimap<Key,T,Compare,KeyContainer,MappedContainer>)
Bibliothek für Zeichenketten
(Konstruktor) (C++23)	konstruiert den basic_string aus einem Bereich (public member function of std::basic_string<CharT,Traits,Allocator>)

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_containers_ranges	202202L	(C++23)	Konstruktor mit Tag zur Konstruktion aus einem containerkompatiblen Bereich

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <string>
 
int main()
{
#ifdef __cpp_lib_containers_ranges
    auto const range = {0x43, 43, 43};
    std::string str{std::from_range, range}; // uses tagged constructor
    assert(str == "C++");
#endif
}

Siehe auch

in_placein_place_typein_place_indexin_place_tin_place_type_tin_place_index_t (C++17)	Tag für In-Place-Konstruktion (Tag)
sorted_equivalentsorted_equivalent_t (C++23)	zeigt an, dass Elemente eines Bereichs sortiert sind (Eindeutigkeit ist nicht erforderlich) (Tag)
sorted_uniquesorted_unique_t (C++23)	zeigt an, dass Elemente eines Bereichs sortiert und eindeutig sind (Tag)
ranges::to (C++23)	konstruiert ein neues Nicht-View-Objekt aus einem Input-Range (Funktions-Template)