Classe Platform::Collections::MapView

Representa uma exibição somente leitura em um mapa, que é uma coleção de pares chave-valor.

Sintaxe

template <
   typename K,
   typename V,
   typename C = ::std::less<K>>
ref class MapView sealed;

Parâmetros

K
O tipo de chave em pares chave-valor.

V
O tipo de valor em pares chave-valor.

C
Um tipo que fornece um objeto de função que pode comparar dois valores de elemento como chaves de classificação para determinar sua ordem relativa em MapView. Por padrão, std::less<K>.

Comentários

MapView é uma implementação concreta em C++ da interface Windows::Foundation::Collections::IMapView <K,V>, que é transmitida pela ABI (interface binária de aplicativo). Para obter mais informações, consulte Coleções (C++/CX).

Membros

Construtores públicos

Nome Descrição
MapView::MapView Inicializa uma nova instância da classe MapView.

Métodos públicos

Nome Descrição
MapView::First Retorna um iterador que é inicializado para o primeiro elemento na exibição do mapa.
MapView::HasKey Determina se o MapView atual contém a chave especificada.
MapView::Lookup Recupera o elemento na chave especificada no objeto MapView atual.
MapView::Tamanho Retorna o número de elementos no objeto MapView atual.
MapView::Split Divide um objeto MapView original em dois objetos MapView.

Hierarquia de herança

MapView

Requisitos

Cabeçalho: collection.h

Namespace: Platform::Collections

Método MapView::First

Retorna um iterador que especifica o primeiro elemento na exibição de mapa.

Sintaxe

virtual Windows::Foundation::Collections::IIterator<
   Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();

Valor retornado

Um iterador que especifica o primeiro elemento na exibição do mapa.

Comentários

Uma maneira conveniente de manter o iterador retornado por First() é atribuir o valor retornado a uma variável declarada com a palavra-chave de dedução do tipo auto. Por exemplo, auto x = myMapView->First();.

Método MapView::HasKey

Determina se o MapView atual contém a chave especificada.

Sintaxe

bool HasKey(K key);

Parâmetros

chave
A chave usada para localizar o elemento MapView. O tipo de key é o typename K.

Valor de retorno

true se a chave for encontrada; caso contrário, false.

Método MapView::Lookup

Recupera o valor do tipo V que está associado à chave especificada do tipo K.

Sintaxe

V Lookup(K key);

Parâmetros

chave
A chave usada para localizar um elemento em MapView. O tipo de key é o typename K.

Valor de retorno

O valor que é emparelhado com key. O tipo do valor retornado é o typename V.

Construtor MapView::MapView

Inicializa uma nova instância da classe MapView.

Sintaxe

explicit MapView(const C& comp = C());

explicit MapView(const ::std::map<K, V, C>& m);

explicit MapView(std::map<K, V, C>&& m);

template <typename InIt> MapView(
    InIt first,
    InIt last,
    const C& comp = C());

MapView(
    ::std::initializer_list<std::pair<const K, V>> il,
    const C& comp = C());

Parâmetros

InIt
O typename de MapView atual.

comp
Um objeto de função que pode comparar dois valores de elemento como chaves de classificação para determinar sua ordem relativa em MapView.

m
Uma referência ou Lvalues e Rvalues para um map Class que é usado para inicializar o MapView atual.

first
O iterador de entrada do primeiro elemento em um intervalo de elementos usados para inicializar o MapView atual.

last
O iterador de entrada do primeiro elemento após um intervalo de elementos usados para inicializar o MapView atual.

il
Um std::initializer_list<std::pair<K,V>> cujos elementos serão inseridos no MapView.

Método MapView::Size

Retorna o número de elementos no objeto MapView atual.

Sintaxe

virtual property unsigned int Size;

Valor retornado

O número de elementos no MapView atual.

Método MapView::Split

Divide o objeto MapView atual em dois objetos MapView. Este método é não operacional.

Sintaxe

void Split(
   Windows::Foundation::Collections::IMapView<
                         K, V>^ * firstPartition,
   Windows::Foundation::Collections::IMapView<
                         K, V>^ * secondPartition);

Parâmetros

firstPartition
A primeira parte do objeto MapView original.

secondPartition
A segunda parte do objeto MapView original.

Comentários

Este método não está operacional; ele não faz nada.

Confira também

Namespace de Plataforma