Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::views::keys — uma vista dos primeiros elementos

std::views::keys cria uma vista preguiçosa dos elementos de índice 0 num intervalo de pares ou tuplos. Permite percorrer as chaves de um mapa, mas também funciona com outros intervalos compatíveis sem criar uma coleção de chaves separada.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <ranges>

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

std::views::keys, disponibilizado por <ranges>, é um adaptador de intervalos equivalente a std::views::elements<0>. Escrever range | std::views::keys significa o mesmo que std::views::keys(range). Seleciona o componente de índice 0 de cada elemento de um intervalo compatível de pares ou tuplos; não se limita a mapas.

A vista é preguiçosa: expõe o componente selecionado quando um iterador é desreferenciado, em vez de construir uma coleção de resultados. Preserva a ordem e os duplicados do intervalo subjacente — não ordena nem elimina duplicados. std::ranges::keys_view<R> é um alias de tipo para std::ranges::elements_view<R, 0>, não o nome do adaptador.

Para um intervalo que produz referências a pares, a vista também pode produzir referências. Nesse caso, é possível alterar o primeiro componente de um par modificável, enquanto as chaves de std::map são constantes. Uma vista criada a partir de um contentor lvalue faz referência a esse contentor: este tem de continuar a existir, e operações que invalidem os seus iteradores podem invalidar os iteradores da vista.

O exemplo escreve 3, 1, 3 em linhas separadas, demonstrando a preservação da ordem e dos duplicados. O código apresentado foi executado sem alterações num ambiente isolado e a saída padrão correspondeu exatamente ao resultado indicado. Para verificar localmente, usa -std=c++23. A fonte é o rascunho de trabalho em evolução, não uma publicação C++23 fixa.

Exemplos

#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';
    }
}

Resultado

3
1
3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes