CKTIS / C++
std::views::take — pogled na prve elemente raspona
std::views::take iz zaglavlja <ranges> stvara pogled na najviše count početnih elemenata raspona. Zadržava njihov redoslijed, ne stvara zaseban spremnik te podržava izravan poziv i zapis s cjevovodom.
Verzija: 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 objekt je adaptera raspona iz zaglavlja <ranges>. Izraz std::views::take(range, count) odgovara zapisu range | std::views::take(count). Ako je count nenegativan i može se prikazati u tipu razlike iteratora raspona, rezultat omogućuje pristup prvim count elementima u izvornom redoslijedu ili cijelom rasponu ako sadrži manje elemenata. Ako je count jednak 0, rezultat je prazan.
To je pogled, a ne kopirani spremnik: primjena adaptera ne kopira elemente u novu kolekciju niti uklanja završne elemente iz izvora. Elementi se čitaju tijekom iteracije. Rezultat ne mora biti tipa std::ranges::take_view; za neke vrste raspona standard propisuje druge jednakovrijedne prikaze pogleda, pa je obično prikladno upotrijebiti auto.
Argument count mora biti pretvoriv u tip razlike iteratora raspona. Upotrijebite nenegativnu vrijednost koja se može prikazati u tom tipu, čak i kada adapter ne konstruira std::ranges::take_view. Primjerice, u optimiziranom slučaju za std::span adapter pretvara count u taj tip prije nego što odredi minimum pretvorene vrijednosti i duljine raspona. Prevelika vrijednost tipa bez predznaka može nakon pretvorbe postati -1 i dovesti do nevaljane aritmetike s iteratorima umjesto odabira cijelog raspona. Kad adapter konstruira std::ranges::take_view, konstruktor zahtijeva da vrijednost nakon pretvorbe bude nenegativna. Negativna vrijednost ne znači brojanje od kraja. Ako je tip ulaznog raspona specijalizacija predloška std::ranges::empty_view, adapter izračunava vrijednost argumenta count i odbacuje je bez konstruiranja std::ranges::take_view, pa negativna vrijednost ne krši taj preduvjet.
Pri prilagodbi postojećeg spremnika preko lvaluea, pogled se odnosi na taj spremnik. Izvor zato mora ostati živ dok se pogled upotrebljava, a operacije koje poništavaju iteratore mogu poništiti i pristup kroz pogled. U primjeru se promjena values[0] nakon stvaranja first vidi u izlazu: 11 20 30. Prikazani kôd izvršen je bez izmjena u izoliranom okruženju. Njegov standardni izlaz točno se podudarao s navedenim izlazom.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.