CKTIS / C++
std::views::take — pogled na prve elemente obsega
std::views::take iz glave <ranges> ustvari pogled na največ count začetnih elementov obsega. Ohrani njihov vrstni red, ne ustvari ločenega vsebnika ter podpira neposreden klic in zapis s cevjo.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <ranges>
std::views::take(range, count)
range | std::views::take(count)std::views::take je objekt prilagoditve obsegov iz glave <ranges>. Izraz std::views::take(range, count) ustreza zapisu range | std::views::take(count). Če je count nenegativen in ga je mogoče predstaviti v tipu za razliko med iteratorjema obsega, rezultat omogoča dostop do prvih count elementov v prvotnem vrstnem redu ali do celotnega obsega, če vsebuje manj elementov. Če je count enak 0, je rezultat prazen.
To je pogled, ne kopiran vsebnik: uporaba prilagoditve ne kopira elementov v novo zbirko in ne odstrani končnih elementov iz vira. Elementi se berejo med iteracijo. Rezultat ni nujno tipa std::ranges::take_view; za nekatere vrste obsegov standard določa druge enakovredne predstavitve pogleda, zato je običajno primerna uporaba auto.
Argument count mora biti pretvorljiv v tip za razliko med iteratorjema obsega. Uporabite nenegativno vrednost, ki jo je mogoče predstaviti v tem tipu, tudi če prilagoditev ne ustvari std::ranges::take_view. V optimiziranem primeru za std::span na primer prilagoditev pretvori count v ta tip, preden določi minimum pretvorjene vrednosti in dolžine obsega. Prevelika vrednost nepodpisanega tipa lahko po pretvorbi postane -1 in povzroči neveljavno aritmetiko z iteratorji, namesto da bi bil izbran celoten obseg. Ko prilagoditev ustvari std::ranges::take_view, konstruktor zahteva, da je vrednost po pretvorbi nenegativna. Negativna vrednost ne pomeni štetja od konca. Če je tip vhodnega obsega specializacija std::ranges::empty_view, prilagoditev ovrednoti argument count in njegovo vrednost zavrže, ne da bi ustvarila std::ranges::take_view. Negativna vrednost zato ne krši tega predpogoja.
Pri prilagoditvi obstoječega vsebnika prek lvalue se pogled sklicuje na ta vsebnik. Vir mora zato ostati živ, dokler se pogled uporablja, operacije, ki razveljavijo iteratorje, pa lahko razveljavijo tudi dostop prek pogleda. V primeru se sprememba values[0] po ustvarjanju first pozna v izpisu: 11 20 30. Prikazana koda je bila brez sprememb izvedena v izoliranem okolju. Njen standardni izhod se je natančno ujemal z navedenim izpisom.
Primeri
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 5> values{10, 20, 30, 40, 50};
auto first = values | std::views::take(3);
values[0] = 11;
bool separator = false;
for (int value : first) {
if (separator) std::cout << ' ';
std::cout << value;
separator = true;
}
std::cout << '\n';
}
Rezultat
11 20 30
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.