WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::views::join — verzögertes Abflachen von Ranges

std::views::join erstellt eine verzögerte Sicht auf Elemente aus einer Range von Ranges. Sie flacht eine Ebene ab, behält die Reihenfolge bei und überspringt leere innere Ranges, ohne einen neuen Container aufzubauen.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <ranges>
std::views::join(r)
r | std::views::join

std::views::join aus <ranges> ist ein Range-Adaptor, der eine std::ranges::join_view erstellt. r | std::views::join entspricht dem Aufruf std::views::join(r). Die äußere Range und ihre inneren Ranges müssen mindestens das sequenzielle Lesen gemäß input_range unterstützen.

Die Sicht flacht genau eine Ebene ab: Sie durchläuft die Elemente aufeinanderfolgender innerer Ranges und überspringt leere Ranges. Sie fügt weder Trennzeichen ein noch erstellt sie einen Ergebniscontainer. Im Beispiel gibt die Schleife die Leerzeichen aus, nicht der Adaptor.

Bei einem als L-Wert übergebenen Container verweist die Sicht auf vorhandene Daten. Der Container muss während der Verwendung der Sicht weiterleben; vermeide Änderungen, die Iteratoren ungültig machen. Ergibt das Dereferenzieren eine veränderbare Referenz, ändert ein Schreibzugriff über diese Referenz das Quellelement.

Setze weder wahlfreien Zugriff noch ein verfügbares size() voraus, auch wenn die Quelle Vektoren verwendet. Die Stärke des Iterators hängt von den Ranges und davon ab, wie ihre Elemente bereitgestellt werden; join_view bietet höchstens bidirektionale Iteration. Der zitierte Arbeitsentwurf wird fortlaufend aktualisiert und ist keine unveränderliche C++23-Spezifikation.

Beispiele

#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';
}

Ergebnis

1 2 3 4

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen