CKTIS / C++
std::views::join — líné zploštění rozsahů
std::views::join vytváří líný pohled na prvky rozsahu rozsahů. Zploští jednu úroveň, zachová pořadí a přeskočí prázdné vnitřní rozsahy, aniž by vytvořil nový kontejner.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::join(r)
r | std::views::joinstd::views::join z hlavičky <ranges> je adaptér rozsahů, který vytváří std::ranges::join_view. Zápis r | std::views::join odpovídá volání std::views::join(r). Vnější rozsah i jeho vnitřní rozsahy musí podporovat alespoň sekvenční čtení požadované konceptem input_range.
Pohled zplošťuje přesně jednu úroveň: prochází prvky po sobě jdoucích vnitřních rozsahů a prázdné rozsahy přeskakuje. Nevkládá oddělovače ani nevytváří výsledný kontejner. V příkladu vypisuje mezery cyklus, nikoli adaptér.
Pokud je kontejner předán jako l-hodnota, pohled odkazuje na existující data. Kontejner musí zůstat živý po dobu používání pohledu; vyhněte se změnám, které zneplatňují iterátory. Pokud dereference vrací modifikovatelnou referenci, zápis přes tuto referenci změní zdrojový prvek.
Nepředpokládejte náhodný přístup ani dostupnost size(), a to ani tehdy, když zdroj používá vektory. Síla iterátoru závisí na rozsazích a na tom, jak jsou zpřístupněny jejich prvky; join_view poskytuje nejvýše obousměrnou iteraci. Citovaný pracovní návrh se průběžně aktualizuje a není neměnnou specifikací C++23.
Příklady
#include <iostream>
#include <ranges>
#include <vector>
int main() {
std::vector<std::vector<int>> rows{{1, 2}, {}, {3, 4}};
auto flat = rows | std::views::join;
bool first = true;
for (int value : flat) {
if (!first) std::cout << ' ';
std::cout << value;
first = false;
}
std::cout << '\n';
}
Výsledek
1 2 3 4
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.