CKTIS / C++
std::ranges::subrange — pohľad na iterátor a sentinel
std::ranges::subrange z hlavičky <ranges> spája začiatočný iterátor a koncový sentinel do pohľadu na [first, last). Nekopíruje prvky do nového kontajnera; umožňuje odovzdať vybranú časť údajov ako jeden objekt.
Verzia: 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> ukladá iterátor a sentinel a vytvára pohľad na [first, last): začiatok je zahrnutý, koniec nie. Typy I a S sa môžu líšiť; úložisko nemusí byť súvislé. Vložte <ranges>. Pri vytvorení std::ranges::subrange(first, last) sa typy šablónových parametrov odvodia.
std::ranges::subrange::begin vracia kópiu uloženého iterátora, ak I spĺňa copyable. Inak je dostupné iba preťaženie bez const, ktoré uložený iterátor presunie; v takom prípade nepredpokladajte, že opakované volania vrátia rovnaký začiatok. std::ranges::subrange::end vracia kópiu sentinelu. Pred dereferencovaním porovnajte iterátor s end(); samotný sentinel nemusí podporovať dereferencovanie.
K vyberá subrange_kind::sized alebo subrange_kind::unsized. Iba variant sized poskytuje size(): výsledok vypočíta odčítaním koncových bodov alebo uloží veľkosť, ak toto odčítanie nie je dostupné. Konštruktor s argumentom n vyžaduje, aby n zodpovedalo skutočnej dĺžke platného rozsahu [first, last).
Pohľad nekopíruje prvky a sám nepredlžuje životnosť údajov. Nepoužívajte ho po zničení údajov alebo zneplatnení jeho iterátorov. Zmena prostredníctvom zapisovateľného iterátora mení pôvodné údaje; const na samotnom pohľade nespôsobí, že jeho prvky budú konštantné.
Príklad zahŕňa values[1], values[2] a values[3]. Po zmene prvého z nich na 21 vypíše presne sum=91 a values[1]=21, každé na samostatnom riadku. Rozsah informácií o prostredí: C++23; príznak kompilátora z repozitára, kompatibilita s produkčným prostredím nie je potvrdená. Online štandard je priebežne sa vyvíjajúci návrh, nie zmrazené vydanie C++23.
Prí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ýsledok
sum=91 values[1]=21
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.