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

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.

Zdroje