CKTIS / C++
std::ranges::subrange — eine Iterator-Sentinel-Ansicht
std::ranges::subrange aus <ranges> verbindet einen Startiterator und einen End-Sentinel zu einer Ansicht von [first, last). Es kopiert keine Elemente in einen neuen Container, sondern ermöglicht, einen ausgewählten Datenabschnitt als ein einzelnes Objekt weiterzugeben.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();std::ranges::subrange<I, S, K> speichert einen Iterator und einen Sentinel und bildet eine Ansicht von [first, last): Der Anfang ist enthalten, das Ende nicht. Die Typen I und S dürfen verschieden sein; der Speicher muss nicht zusammenhängend sein. Binde <ranges> ein. Bei std::ranges::subrange(first, last) werden die Vorlagenargumente automatisch abgeleitet.
std::ranges::subrange::begin gibt eine Kopie des gespeicherten Iterators zurück, wenn I copyable erfüllt. Andernfalls ist nur die nicht-const-Überladung verfügbar, die den gespeicherten Iterator verschiebt. Gehe in diesem Fall nicht davon aus, dass wiederholte Aufrufe denselben Anfang liefern. std::ranges::subrange::end gibt eine Kopie des Sentinels zurück. Vergleiche einen Iterator vor dem Dereferenzieren mit end(); der Sentinel selbst muss keine Dereferenzierung unterstützen.
K legt subrange_kind::sized oder subrange_kind::unsized fest. Nur die Variante sized bietet size(): Sie berechnet das Ergebnis durch Subtraktion der Endpunkte oder speichert eine Größe, wenn diese Subtraktion nicht verfügbar ist. Der Konstruktor mit dem Argument n setzt voraus, dass n der tatsächlichen Länge des gültigen Bereichs [first, last) entspricht.
Die Ansicht kopiert weder Elemente noch verlängert sie selbst die Lebensdauer der Daten. Verwende sie nicht, nachdem die Daten zerstört wurden oder ihre Iteratoren ungültig geworden sind. Änderungen über einen beschreibbaren Iterator wirken sich auf die ursprünglichen Daten aus; const für die Ansicht selbst macht ihre Elemente nicht konstant.
Das Beispiel umfasst values[1], values[2] und values[3]. Nachdem das erste dieser Elemente auf 21 gesetzt wurde, gibt es genau sum=91 und values[1]=21 aus, jeweils in einer eigenen Zeile. Umfang der Umgebungsangabe: C++23; Compiler-Flag des Repositorys, Produktionslaufzeit nicht bestätigt. Der Online-Standard ist ein fortlaufend weiterentwickelter Entwurf und keine eingefrorene C++23-Veröffentlichung.
Beispiele
#include <iostream>
#include <ranges>
int main() {
int values[] = {10, 20, 30, 40, 50};
auto middle = std::ranges::subrange(values + 1, values + 4);
*middle.begin() = 21;
int sum = 0;
for (auto it = middle.begin(); it != middle.end(); ++it) {
sum += *it;
}
std::cout << "sum=" << sum << '\n';
std::cout << "values[1]=" << values[1] << '\n';
}
Ergebnis
sum=91 values[1]=21
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.