Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri