CKTIS / C++
std::views::take — pohled na první prvky rozsahu
std::views::take z hlavičky <ranges> vytvoří pohled na nejvýše count počátečních prvků rozsahu. Zachová jejich pořadí, nevytváří samostatný kontejner a lze jej použít přímým voláním i v zápisu s rourou.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::take(range, count)
range | std::views::take(count)std::views::take je objekt adaptéru rozsahů poskytovaný hlavičkou <ranges>. Výraz std::views::take(range, count) odpovídá zápisu range | std::views::take(count). Je-li count nezáporný a lze-li jej reprezentovat v rozdílovém typu iterátorů daného rozsahu, výsledek zpřístupňuje prvních count prvků v původním pořadí, případně celý rozsah, pokud obsahuje méně prvků. Je-li count rovno 0, je výsledek prázdný.
Jde o pohled, nikoli o zkopírovaný kontejner: použití adaptéru nekopíruje prvky do nové kolekce ani neodstraňuje koncové prvky ze zdroje. Prvky se čtou při iteraci. Výsledek nemusí mít typ std::ranges::take_view; pro některé druhy rozsahů standard stanovuje jiné rovnocenné reprezentace pohledu, proto se obvykle hodí auto.
Argument count musí být převoditelný na rozdílový typ iterátorů daného rozsahu. Použijte nezápornou hodnotu reprezentovatelnou v tomto typu, i když adaptér nevytváří std::ranges::take_view. Například v optimalizovaném případě pro std::span adaptér nejprve převede count na tento typ a teprve potom určí minimum z převedené hodnoty a délky rozsahu. Příliš velká hodnota typu bez znaménka může po převodu nabýt hodnoty -1 a vést k neplatné aritmetice iterátorů namísto výběru celého rozsahu. Pokud adaptér vytváří std::ranges::take_view, konstruktor vyžaduje, aby hodnota po převodu byla nezáporná. Záporná hodnota neznamená počítání od konce. Je-li typ vstupního rozsahu specializací std::ranges::empty_view, adaptér vyhodnotí argument count a jeho hodnotu zahodí, aniž by vytvořil std::ranges::take_view. Záporná hodnota tedy tuto předpodmínku neporušuje.
Při adaptaci existujícího kontejneru přes lvalue se pohled na tento kontejner odkazuje. Zdroj proto musí zůstat živý po dobu používání pohledu a operace zneplatňující iterátory mohou zneplatnit i přístup přes pohled. V příkladu se změna values[0] po vytvoření first projeví ve výstupu: 11 20 30. Zobrazený kód byl spuštěn beze změn v izolovaném prostředí. Jeho standardní výstup se přesně shodoval s uvedeným výstupem.
Příklady
#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';
}
Výsledek
11 20 30
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.