Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje