WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::ranges::to — einen Container aus einem Range erstellen

C++23 std::ranges::to erstellt aus einem Eingabe-Range ein Objekt, meist einen Container. Damit lässt sich eine View-Pipeline mit einem konkreten Ergebnis abschließen, indem entweder der vollständige Containertyp oder eine Vorlage angegeben wird, deren Argumente deduziert werden.

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

Syntax

std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)

std::ranges::to, seit C++23 in <ranges> verfügbar, erstellt ein Ergebnis aus einem Range, der input_range erfüllt. Bei einem Container wie std::vector<int> materialisiert die Funktion die Elemente, statt eine weitere verzögerte View zu erzeugen. Der Zieltyp C muss ein cv-unqualifizierter Klassentyp sein und darf view nicht erfüllen.

Der Ausdruck std::ranges::to<std::vector<int>>(range) gibt den Ergebnistyp ausdrücklich an. Die Form std::ranges::to<std::vector>(range) verwendet die Klassenvorlagen-Argumentdeduktion. In einer Pipeline verwendet man range | std::ranges::to<std::vector<int>>(): Die () erzeugen ein Pipeline-Abschlussobjekt. Zusätzliche args..., etwa ein Allocator, werden an den ausgewählten Containerkonstruktor weitergereicht.

Bei direkt konvertierbaren Elementen versucht die Funktion der Reihe nach: einen Konstruktor, der den Range akzeptiert, einen mit std::from_range markierten Konstruktor, einen passenden Iteratorpaar-Konstruktor und schließlich die Konstruktion mit args... gefolgt vom Einfügen der Elemente. Jeder Weg hat eigene Anforderungen. Verschachtelte Ranges können rekursiv konvertiert werden; passt kein zulässiger Weg, ist das Programm fehlerhaft.

Das Beispiel erstellt einen std::vector<int> mit den Quadraten von 1 bis 5; die obere Grenze von std::views::iota(1, 6) ist ausgeschlossen. Das Materialisieren dieser Pipeline durchläuft ihre Elemente. Verwende daher keinen unbegrenzten Range, ohne die Anzahl seiner Elemente zu begrenzen. Erforderlich ist eine Bibliotheksimplementierung, die dieses C++23-Feature unterstützt: Das Compiler-Flag des Repositorys allein belegt keine Unterstützung in der Produktionsumgebung. Die angegebene Referenz ist ein weiterentwickelter Standardentwurf, keine unveränderliche C++23-Ausgabe.

Beispiele

#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>

int main() {
    auto values = std::views::iota(1, 6)
        | std::views::transform([](int n) { return n * n; })
        | std::ranges::to<std::vector<int>>();

    for (std::size_t i = 0; i < values.size(); ++i) {
        if (i != 0) std::cout << ' ';
        std::cout << values[i];
    }
    std::cout << '\n';
}

Ergebnis

1 4 9 16 25

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