Platform::Collections::MapView (Clase)

Representa una vista de solo lectura en un mapa, que es una colección de pares clave-valor.

Sintaxis

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

Parámetros

K
Tipo de la clave del par clave-valor.

V
Tipo del valor del par clave-valor.

C
Un tipo que proporciona un objeto de función que puede comparar dos valores de elemento como claves de ordenación para determinar su orden relativo en el objeto MapView. De forma predeterminada, std::less<K>.

Comentarios

MapView es la implementación concreta en C++ de la interfaz Windows::Foundation::Collections::IMapView <K,V> que se pasa a través de la interfaz binaria de aplicación (ABI). Para obtener más información, consulta Colecciones (C++/CX).

Miembros

Constructores públicos

Nombre	Descripción
MapView::MapView	Inicializa una nueva instancia de la clase MapView.

Métodos públicos

Nombre	Descripción
MapView::First	Devuelve un iterador que se inicializa el primer elemento en la vista de mapa.
MapView::HasKey	Determina si el objeto MapView actual contiene la clave especificada.
MapView::Lookup	Recupera el elemento en la clave especificada del objeto MapView actual.
MapView::Size	Devuelve el número de elementos del objeto MapView actual.
MapView::Split	Divide un objeto MapView original en dos objetos MapView.

Jerarquía de herencia

MapView

Requisitos

Encabezado: collection.h

Espacio de nombres: Platform::Collections

MapView::First (Método)

Devuelve un iterador que especifica el primer elemento de la vista de mapa.

Sintaxis

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

Valor devuelto

Un iterador que especifica el primer elemento de la vista de mapa.

Comentarios

Una manera cómoda de contener el iterador devuelto por First() es asignar el valor devuelto a una variable que se declara con la palabra clave de deducción de tipos auto. Por ejemplo, auto x = myMapView->First();.

MapView::HasKey (Método)

Determina si el objeto MapView actual contiene la clave especificada.

Sintaxis

bool HasKey(K key);

Parámetros

key
La clave que se usa para ubicar el elemento MapView. El tipo de key es typename K.

Valor devuelto

true si se encuentra la clave; de lo contrario, false.

MapView::Lookup (Método)

Recupera el valor de tipo V asociado a la clave especificada de tipo K.

Sintaxis

V Lookup(K key);

Parámetros

key
La clave utilizada para buscar un elemento en el objeto MapView. El tipo de key es typename K.

Valor devuelto

El valor que se empareja con key. El tipo del valor devuelto es typename V.

MapView::MapView (Constructor)

Inicializa una nueva instancia de la clase MapView.

Sintaxis

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
El typename del objeto MapView actual.

comp
Objeto de función que puede comparar dos valores de elemento como claves de ordenación para determinar su orden relativo en el objeto MapView.

m
Una referencia o Lvalues y Rvalues a un objeto map Class que se usa para inicializar el objeto MapView actual.

first
El iterador de entrada del primer elemento en un intervalo de elementos utilizados para inicializar el objeto MapView actual.

last
El iterador de entrada del primer elemento tras un intervalo de elementos utilizados para inicializar el objeto MapView actual.

il
std::initializer_list<std::pair<K,V>> cuyos elementos se van a insertar en el objeto MapView.

MapView::Size (Método)

Devuelve el número de elementos del objeto MapView actual.

Sintaxis

virtual property unsigned int Size;

Valor devuelto

Número de elementos del objeto MapView actual.

MapView::Split (Método)

Divide el objeto MapView actual en dos objetos MapView. Este método no es operativo.

Sintaxis

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

Parámetros

firstPartition
La primera parte del objeto MapView original.

secondPartition
La segunda parte del objeto MapView original.

Comentarios

Este método no es operativo; no realiza ninguna acción.

Consulte también

Espacio de nombres de plataforma