CKTIS / C++
std::ranges::subrange — pohled na iterátor a sentinel
std::ranges::subrange z hlavičky <ranges> spojuje počáteční iterátor a koncový sentinel do pohledu na [first, last). Nekopíruje prvky do nového kontejneru; umožňuje předat vybranou část dat jako jeden objekt.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();std::ranges::subrange<I, S, K> ukládá iterátor a sentinel a vytváří pohled na [first, last): začátek je zahrnutý, konec nikoli. Typy I a S se mohou lišit; úložiště nemusí být souvislé. Vložte <ranges>. Při vytvoření std::ranges::subrange(first, last) se typy šablonových parametrů odvodí.
std::ranges::subrange::begin vrací kopii uloženého iterátoru, pokud I splňuje copyable. Jinak je dostupné pouze přetížení bez const, které uložený iterátor přesune; v takovém případě nepředpokládejte, že opakovaná volání vrátí stejný začátek. std::ranges::subrange::end vrací kopii sentinelu. Před dereferencováním porovnejte iterátor s end(); samotný sentinel nemusí dereferenci podporovat.
K vybírá subrange_kind::sized nebo subrange_kind::unsized. Pouze varianta sized poskytuje size(): výsledek vypočítá odečtením koncových bodů, nebo uloží velikost, pokud toto odečtení není dostupné. Konstruktor s argumentem n vyžaduje, aby n odpovídalo skutečné délce platného rozsahu [first, last).
Pohled nekopíruje prvky a sám neprodlužuje životnost dat. Nepoužívejte jej po zničení dat nebo zneplatnění jeho iterátorů. Změna prostřednictvím zapisovatelného iterátoru mění původní data; const na samotném pohledu nezpůsobí, že jeho prvky budou konstantní.
Příklad zahrnuje values[1], values[2] a values[3]. Po změně prvního z nich na 21 vypíše přesně sum=91 a values[1]=21, každé na samostatném řádku. Rozsah informací o prostředí: C++23; příznak kompilátoru z repozitáře, kompatibilita s produkčním prostředím není potvrzena. Online standard je průběžně se vyvíjející návrh, nikoli zmrazené vydání C++23.
Příklady
#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';
}
Výsledek
sum=91 values[1]=21
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.