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.