Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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::join

std::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.

Zdroje