Platform::Collections::MapView-Klasse

Stellt eine schreibgeschützte Ansicht einer Zuordnungdar, die eine Auflistung von Schlüssel-Wert-Paaren ist.

Syntax

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

Parameter

K
Der Typ des Schlüssels im Schlüssel-Wert-Paar.

V
Der Typ des Werts im Schlüssel-Wert-Paar.

C
Ein Typ, der ein Funktionsobjekt bereitstellt, das zwei Elementwerte als Sortierschlüssel vergleichen kann, um deren relative Reihenfolge in der MapView zu bestimmen. Standardmäßig std ::less<K>.

Hinweise

MapView ist eine konkrete C++-Implementierung der Windows::Foundation::Collections::IMapView <K,V-Schnittstelle> , die über die Anwendungs-Binärschnittstelle (ABI) übergeben wird. Weitere Informationen finden Sie unter Auflistungen (C++/CX).

Member

Öffentliche Konstruktoren

Name Beschreibung
MapView::MapView Initialisiert eine neue Instanz der MapView-Klasse.

Öffentliche Methoden

Name Beschreibung
MapView::First Gibt einen Iterator zurück, der mit dem ersten Element der Zuordnungsansicht initialisiert wird.
MapView::HasKey Ermittelt, ob die aktuelle MapView den angegebenen Schlüssel enthält.
MapView::Lookup Ruft das Element am angegebenen Schlüssel im aktuellen MapView-Objekt ab.
MapView::Size Gibt die Anzahl von Elementen im aktuellen MapView-Objekt zurück.
MapView::Split Teilt ein Original-MapView-Objekt in zwei MapView-Objekte.

Vererbungshierarchie

MapView

Anforderungen

Header: collection.h

Namespace: Platform::Collections

MapView::First-Methode

Gibt einen Iterator zurück, der das erste Element in der Kartenansicht angibt.

Syntax

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

Rückgabewert

Ein Iterator, der das erste Element in der Kartenansicht angibt.

Hinweise

Eine bequeme Möglichkeit zum Speichern des iterators, der von First() zurückgegeben wird, ist das Zuweisen des Rückgabewerts zu einer Variablen, die mit dem auto Typabzug Schlüsselwort (keyword) deklariert wird. Beispiel: auto x = myMapView->First();.

MapView::HasKey-Methode

Ermittelt, ob die aktuelle MapView den angegebenen Schlüssel enthält.

Syntax

bool HasKey(K key);

Parameter

key
Der zum Suchen des MapView-Elements verwendete Schlüssel. Der Schlüsseltyp ist Typename K.

Rückgabewert

truewenn der Schlüssel gefunden wird; andernfalls . false

MapView::Lookup-Methode

Ruft den Wert des Typs V ab, der dem angegebenen Schlüssel des Typs K zugeordnet ist.

Syntax

V Lookup(K key);

Parameter

key
Der zum Suchen eines in der MapView vorhandenen Elements verwendete Schlüssel. Der Typ des Typs key ist " K".

Rückgabewert

Der Wert, der dem key zugeordnet ist. Der Typ des Rückgabewerts ist typename V.

MapView::MapView-Konstruktor

Initialisiert eine neue Instanz der MapView-Klasse.

Syntax

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());

Parameter

Init
Der Typname der aktuellen MapView.

comp
Ein Funktionsobjekt, das zwei Elementwerte als Sortierschlüssel vergleichen kann, um deren relative Reihenfolge in der MapView zu bestimmen.

m
Ein Verweis oder Lvalues und Rvalues auf ein map Class Objekt, das zum Initialisieren der aktuellen MapView verwendet wird.

first
Der Eingabeiterator des ersten Elements in einem Bereich von Elementen, die verwendet werden, um die aktuelle MapView zu initialisieren.

last
Der Eingabeiterator des ersten Elements nach einem Bereich von Elementen, die verwendet werden, um die aktuelle MapView zu initialisieren.

Il
Ein std::initializer_list<std::p air<K,V>> , dessen Elemente in die MapView eingefügt werden.

MapView::Size-Methode

Gibt die Anzahl von Elementen im aktuellen MapView-Objekt zurück.

Syntax

virtual property unsigned int Size;

Rückgabewert

Die Anzahl der Elemente in der aktuellen MapView.

MapView::Split-Methode

Teilt das aktuelle MapView-Objekt in zwei MapView-Objekte. Diese Methode führt keine Operationen aus.

Syntax

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

Parameter

firstPartition
Der erste Teil des ursprünglichen MapView-Objekts.

secondPartition
Der zweite Teil des ursprünglichen MapView-Objekts.

Hinweise

Diese Methode führt keine Operationen aus und hat keine Auswirkungen.

Siehe auch

Plattformnamespace