CKTIS / C++
std::ranges::subrange — pogled na iterator in sentinel
std::ranges::subrange iz <ranges> združi začetni iterator in končni sentinel v pogled na [first, last). Elementov ne kopira v nov vsebnik, temveč omogoča, da izbrani del podatkov posredujete kot en sam objekt.
Različica: 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> shrani iterator in sentinel ter tvori pogled na [first, last): začetek je vključen, konec pa ne. Tipi I in S se lahko razlikujejo; shramba ni nujno zvezna. Vključite <ranges>. Pri konstrukciji std::ranges::subrange(first, last) se argumenti predloge določijo z dedukcijo.
std::ranges::subrange::begin vrne kopijo shranjenega iteratorja, kadar I izpolnjuje copyable. Sicer je na voljo samo preobremenitev brez const, ki premakne shranjeni iterator; v tem primeru ne predpostavljajte, da bodo ponovljeni klici vrnili isti začetek. std::ranges::subrange::end vrne kopijo sentinela. Pred dereferenciranjem primerjajte iterator z end(); sam sentinel dereferenciranja ne potrebuje podpirati.
K izbere subrange_kind::sized ali subrange_kind::unsized. Samo različica sized zagotavlja size(): rezultat izračuna z odštevanjem končnih točk ali shrani velikost, kadar to odštevanje ni na voljo. Konstruktor z argumentom n zahteva, da je n enak dejanski dolžini veljavnega obsega [first, last).
Pogled ne kopira elementov in sam ne podaljša življenjske dobe podatkov. Ne uporabljajte ga, ko so podatki uničeni ali njegovi iteratorji neveljavni. Sprememba prek zapisljivega iteratorja spremeni izvirne podatke; če je const sam pogled, to še ne pomeni, da so njegovi elementi konstantni.
Primer zajema values[1], values[2] in values[3]. Ko prvega od teh elementov spremeni na 21, izpiše natančno sum=91 in values[1]=21, vsakega v svoji vrstici. Obseg informacij o okolju: C++23; zastavica prevajalnika iz repozitorija, združljivost s produkcijskim okoljem ni potrjena. Spletni standard je razvijajoči se osnutek, ne nespremenjena izdaja C++23.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.