CKTIS / C++
std::ranges::subrange — pogled na iterator i sentinel
std::ranges::subrange iz zaglavlja <ranges> povezuje početni iterator i završni sentinel u pogled na [first, last). Ne kopira elemente u novi spremnik; omogućuje prosljeđivanje odabranog dijela podataka kao jednog objekta.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <ranges>
std::ranges::subrange r(first, last);
r.begin();
r.end();std::ranges::subrange<I, S, K> pohranjuje iterator i sentinel te oblikuje pogled na [first, last): početak je uključen, a kraj nije. Tipovi I i S mogu se razlikovati; pohrana ne mora biti neprekinuta. Uključite <ranges>. Pri konstrukciji std::ranges::subrange(first, last) tipovi predloška određuju se dedukcijom.
std::ranges::subrange::begin vraća kopiju pohranjenog iteratora kada I zadovoljava copyable. Inače je dostupno samo preopterećenje koje nije const i koje premješta pohranjeni iterator; u tom slučaju nemojte pretpostaviti da će ponovljeni pozivi vratiti isti početak. std::ranges::subrange::end vraća kopiju sentinela. Prije dereferenciranja usporedite iterator s end(); sam sentinel ne mora podržavati dereferenciranje.
K odabire subrange_kind::sized ili subrange_kind::unsized. Samo varijanta sized pruža size(): rezultat izračunava oduzimanjem krajnjih točaka ili pohranjuje veličinu ako to oduzimanje nije dostupno. Konstruktor koji prima argument n zahtijeva da n odgovara stvarnoj duljini valjanog raspona [first, last).
Pogled ne kopira elemente niti sam produljuje životni vijek podataka. Nemojte ga upotrebljavati nakon uništenja podataka ili poništavanja valjanosti njegovih iteratora. Promjena putem zapisivog iteratora mijenja izvorne podatke; const na samom pogledu ne čini njegove elemente konstantnima.
Primjer obuhvaća values[1], values[2] i values[3]. Nakon što prvi od njih promijeni u 21, ispisuje točno sum=91 i values[1]=21, svaki u zasebnom retku. Opseg informacija o okruženju: C++23; oznaka prevoditelja iz repozitorija, kompatibilnost s produkcijskim okruženjem nije potvrđena. Mrežni standard je nacrt koji se razvija, a ne zamrznuto izdanje C++23.
Primjeri
#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';
}
Rezultat
sum=91 values[1]=21
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.