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.

B
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::lessK<>.

Hinweise

MapView ist eine konkrete C++-Implementierung der Windows::Foundation::Collections::IMapView <K,V-Schnittstelle>, die über die Anwendungsbinärschnittstelle (Application Binary Interface, 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 praktische Möglichkeit, den von First() zurückgegebenen Iterator zu speichern, besteht darin, den Rückgabewert einer Variablen zuzuweisen, die mit dem auto Typableitungsschlüsselwort 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 Typ des Schlüssels ist Typname K.

Rückgabewert

true , wenn der Schlüssel gefunden wird; falseandernfalls .

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 von key ist Typname K.

Rückgabewert

Der Wert, der dem key zugeordnet ist. Der Typ des Rückgabewerts ist Typname 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 einen map Class , der 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 airK,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