Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::views::take — pohľad na prvé prvky rozsahu

std::views::take z hlavičky <ranges> vytvorí pohľad na najviac count počiatočných prvkov rozsahu. Zachová ich poradie, nevytvára samostatný kontajner a možno ho použiť priamym volaním aj zápisom s rúrou.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take je objekt adaptéra rozsahov poskytovaný hlavičkou <ranges>. Výraz std::views::take(range, count) zodpovedá zápisu range | std::views::take(count). Ak je count nezáporný a dá sa reprezentovať v rozdielovom type iterátorov daného rozsahu, výsledok sprístupňuje prvých count prvkov v pôvodnom poradí alebo celý rozsah, ak obsahuje menej prvkov. Ak je count rovné 0, výsledok je prázdny.

Ide o pohľad, nie o skopírovaný kontajner: použitie adaptéra nekopíruje prvky do novej kolekcie ani neodstraňuje koncové prvky zo zdroja. Prvky sa čítajú počas iterácie. Výsledok nemusí mať typ std::ranges::take_view; pre niektoré druhy rozsahov štandard určuje iné rovnocenné reprezentácie pohľadu, preto je zvyčajne vhodné použiť auto.

Argument count musí byť konvertovateľný na rozdielový typ iterátorov daného rozsahu. Použite nezápornú hodnotu reprezentovateľnú v tomto type, aj keď adaptér nevytvára std::ranges::take_view. Napríklad v optimalizovanom prípade pre std::span adaptér najprv konvertuje count na tento typ a až potom určí minimum z konvertovanej hodnoty a dĺžky rozsahu. Príliš veľká hodnota typu bez znamienka sa môže konvertovať na -1 a viesť k neplatnej aritmetike iterátorov namiesto výberu celého rozsahu. Ak adaptér vytvára std::ranges::take_view, konštruktor vyžaduje, aby hodnota po konverzii bola nezáporná. Záporná hodnota neznamená počítanie od konca. Ak je typ vstupného rozsahu špecializáciou std::ranges::empty_view, adaptér vyhodnotí argument count a jeho hodnotu zahodí bez vytvorenia std::ranges::take_view, takže záporná hodnota túto predpodmienku neporušuje.

Pri adaptovaní existujúceho kontajnera cez lvalue sa pohľad na tento kontajner odkazuje. Zdroj preto musí zostať živý počas používania pohľadu a operácie, ktoré zneplatnia iterátory, môžu zneplatniť aj prístup cez pohľad. V príklade sa zmena values[0] po vytvorení first prejaví vo výstupe: 11 20 30. Zobrazený kód sa spustil bez zmien v izolovanom prostredí. Jeho štandardný výstup sa presne zhodoval s uvedeným výstupom.

Prí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ýsledok

11 20 30

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje