std::ranges::views::join_with, std::ranges::join_with_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::join_with_view

Memberfunktionen

join_with_view::join_with_view

join_with_view::base

join_with_view::begin

join_with_view::end

Deduction Guides

Iterator

Memberfunktionen

join_with_view::iterator::iterator

join_with_view::iterator::operator*

join_with_view::iterator::operator++ join_with_view::iterator::operator++(int) join_with_view::iterator::operator-- join_with_view::iterator::operator--(int)

Nicht-Member-Funktionen

operator==(join_with_view::iterator) (C++23)

iter_move(join_with_view::iterator) (C++23)

iter_swap(join_with_view::iterator) (C++23)

Sentinel

join_with_view::sentinel::sentinel

operator==(join_with_view::sentinel) (C++23)

 

Definiert in der Header-Datei <ranges>
template< ranges::input_range V, ranges::forward_range Pattern >   requires ranges::view<V> &&            ranges::input_range<ranges::range_reference_t<V>> &&            ranges::view<Pattern> &&            /*concatable*/<ranges::range_reference_t<V>, Pattern> class join_with_view :     ranges::view_interface<join_with_view<V, Pattern>>	(1)	(seit C++23)
namespace views {     inline constexpr /* unspecified */ join_with = /* unspecified */; }	(2)	(seit C++23)
Aufruf-Signatur
template< ranges::viewable_range R, class Pattern >     requires /* siehe unten */ constexpr ranges::view auto join_with( R&& r, Pattern&& pattern );		(seit C++23)
template< class Pattern > constexpr /* range adaptor closure */ join_with( Pattern&& pattern );		(seit C++23)

1) Ein Range-Adaptor, der eine view repräsentiert, die aus der Sequenz besteht, die durch das Abflachen einer View von Ranges erhalten wird, wobei jedes Element des Trennzeichens zwischen den Elementen der View eingefügt wird. Das Trennzeichen kann ein einzelnes Element oder eine View von Elementen sein.

Für die Definition von /*concatable*/ siehe std::ranges::concat_view.

2) RangeAdaptorObject. Der Ausdruck views::join_with(e, f) ist ausdrucksäquivalent zu join_with_view(e, f) für beliebige geeignete Teilausdrücke e und f.

join_with_view modelliert input_range.

join_with_view modelliert forward_range, wenn

• ranges::range_reference_t<V> eine Referenz ist und
• V und ranges::range_reference_t<V>> jeweils forward_range modellieren.

join_with_view modelliert bidirectional_range, wenn

• ranges::range_reference_t<V> eine Referenz ist,
• V, ranges::range_reference_t<V>> und Pattern jeweils bidirectional_range modellieren und
• ranges::range_reference_t<V> und Pattern jeweils common_range modellieren.

join_with_view modelliert common_range, wenn

• ranges::range_reference_t<V> eine Referenz ist und
• V und ranges::range_reference_t<V>> jeweils forward_range und common_range modellieren.

Verschachtelte Typen

Typ	Definition
InnerRng	ranges::range_reference_t<V> ((nur zur Veranschaulichung)*)

Datenelemente

Mitglied	Definition
V base_	die zugrunde liegende (angepasste) View ((exposition-only member object*)
Pattern pattern_	das Musterobjekt ((exposition-only member object*)
non-propagating-cache <ranges::iterator_t<V>> outer_it_ (vorhanden nur, wenn V nicht forward_range modelliert)	der Cache des äußeren Iterators ((exposition-only member object*)
non-propagating-cache <std::remove_cv_t<InnerRng >> inner_ (vorhanden nur, wenn std::is_reference_v<InnerRng > false ist)	der Cache des inneren Ranges ((exposition-only member object*)

Member-Funktionen

(Konstruktor)	konstruiert eine join_with_view (öffentliche Member-Funktion)
base	gibt eine Kopie der zugrunde liegenden (angepassten) View zurück (public member function)
begin	gibt einen Iterator zum Anfang zurück (öffentliche Member-Funktion)
end	gibt einen Iterator oder Sentinel zum Ende zurück (öffentliche Member-Funktion)
Geerbt von std::ranges::view_interface
empty	gibt zurück, ob die abgeleitete Ansicht leer ist, bereitgestellt nur, wenn sie sized_range oder forward_range erfüllt (public member function of std::ranges::view_interface<D>)
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>)

Verschachtelte Klassen

iterator	der Iterator-Typ ((nur zur Veranschaulichung Exposition-only Member-Klassenschablone)*)
sentinel	der Sentinel-Typ ((nur zur Veranschaulichung Exposition-only Member-Klassenschablone)*)

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_ranges_join_with	202202L	(C++23)	std::ranges::join_with_view

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <ranges>
#include <string_view>
#include <vector>
 
int main()
{
    using namespace std::literals;
 
    std::vector v{"This"sv, "is"sv, "a"sv, "test."sv};
    auto joined = v | std::views::join_with(' ');
 
    for (auto c : joined)
        std::cout << c;
    std::cout << '\n';
}

Ausgabe

This is a test.

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 4074	C++23	join_with_view war unterparametrisiert	die Constraints wurden aktualisiert

Siehe auch

ranges::join_viewviews::join (C++20)	ein view, der aus der Sequenz besteht, die durch Abflachung eines view von ranges gebildet wird (Klassen-Template) (Range-Adaptor-Objekt)
ranges::concat_viewviews::concat (C++26)	ein view, der aus der Verkettung der adaptierten Views besteht (Klassen-Template) (Customization Point Objekt)