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

CKTIS / C++

std::views::keys — pohled na první prvky

std::views::keys vytváří líný pohled na prvky s indexem 0 v rozsahu párů nebo n-tic. Umožňuje procházet klíče mapy, ale funguje i s jinými kompatibilními rozsahy, aniž by vytvářel samostatnou kolekci klíčů.

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

Syntaxe

#include <ranges>

std::views::keys(range)
range | std::views::keys

std::views::keys, poskytované hlavičkou <ranges>, je adaptér rozsahu ekvivalentní k std::views::elements<0>. Zápis range | std::views::keys znamená totéž co std::views::keys(range). Z každého prvku kompatibilního rozsahu párů nebo n-tic vybírá komponentu s indexem 0; neomezuje se pouze na mapy.

Pohled je líný: vybranou komponentu zpřístupní při dereferenci iterátoru, místo aby vytvářel výslednou kolekci. Zachovává pořadí i duplicity podkladového rozsahu — netřídí ani neodstraňuje duplicity. std::ranges::keys_view<R> je alias typu pro std::ranges::elements_view<R, 0>, nikoli název adaptéru.

U rozsahu, jehož prvky jsou reference na páry, může pohled také poskytovat reference. První komponentu měnitelného páru pak lze změnit, zatímco klíče std::map jsou konstantní. Pohled vytvořený z lvalue kontejneru na tento kontejner odkazuje: kontejner musí zůstat naživu a operace, které zneplatní jeho iterátory, mohou zneplatnit i iterátory pohledu.

Příklad vypíše 3, 1, 3 na samostatné řádky a ukazuje zachování pořadí i duplicit. Zobrazený kód byl spuštěn beze změn v izolovaném prostředí a jeho standardní výstup přesně odpovídal uvedenému výsledku. Pro místní ověření použijte -std=c++23. Zdrojem je průběžně vyvíjený pracovní návrh, nikoli neměnné vydání C++23.

Příklady

#include <array>
#include <iostream>
#include <ranges>
#include <utility>

int main() {
    std::array<std::pair<int, int>, 3> entries{{
        {3, 30}, {1, 10}, {3, 99}
    }};

    auto keys = entries | std::views::keys;
    for (const auto& key : keys) {
        std::cout << key << '\n';
    }
}

Výsledek

3
1
3

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