winrt::map_base-Strukturvorlage (C++/WinRT)

  • Artikel

Eine Basisklasse, von der Sie ihre eigene benutzerdefinierte nicht beobachtete assoziative Auflistung implementieren können. Weitere Informationen und Codebeispiele finden Sie unter Sammlungen mit C++/WinRT.

Syntax

template <typename D, typename K, typename V>
struct map_base : map_view_base<D, K, V, winrt::impl::collection_version>

Vorlagenparameter

typename D Ihr abgeleiteter Typname.

typename K Der Typ der Schlüssel in der Auflistung.

typename V Der Typ der Werte in der Auflistung.

Anforderungen

Mindest unterstütztes SDK: Windows SDK Version 10.0.17763.0 (Windows 10, Version 1809)

Namespace: winrt

Header: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (standardmäßig enthalten)

Memberfunktionen

Funktion BESCHREIBUNG
map_base::Funktion löschen Entfernt alle Elemente aus dem map_base-Objekt .
map_base::Erste Funktion Ruft einen IIterator ab, der das erste Element im map_base-Objekt darstellt.
map_base::GetView-Funktion Ruft eine unveränderliche Ansicht des map_base-Objekts ab.
map_base::HasKey-Funktion Bestimmt, ob der angegebene Schlüssel zu einem Element im map_base-Objekt gehört.
map_base::Funktion einfügen Fügt ein Oder aktualisiert ein Element im map_base-Objekt .
map_base::Nachschlagefunktion Sucht das durch den angegebenen Schlüssel identifizierte Element nach, und ruft den entsprechenden Wert ab.
map_base::Remove-Funktion Entfernt ein Element aus dem map_base-Objekt .
map_base::Size-Funktion Ruft die Anzahl der Elemente im map_base-Objekt ab.

Iterators

Ein map_base ist ein Bereich, und dieser Bereich wird durch interne freie Funktionen definiert (jeweils ein Iterator abgerufen), der mit Standardsprachefeatures kompatibel ist. Aus diesem Grund können Sie die Elemente in einem map_base-Objekt mit einer bereichsbasierten for Anweisung aufzählen.

Sie können auch einen IIterator aus der map_base::First-Funktion abrufen und diese verwenden, um die Elemente in einem map_base-Objekt zu iterieren.

...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyMap :
    implements<MyMap, IMap<winrt::hstring, int>, IMapView<winrt::hstring, int>, IIterable<IKeyValuePair<winrt::hstring, int>>>,
    winrt::map_base<MyMap, winrt::hstring, int>
{
    auto& get_container() const noexcept
    {
        return m_values;
    }

    auto& get_container() noexcept
    {
        return m_values;
    }

private:
    std::map<winrt::hstring, int> m_values{
        { L"AliceBlue", 0xfff0f8ff }, { L"AntiqueWhite", 0xfffaebd7 }
    };
};
...
IMap<winrt::hstring, int> map{ winrt::make<MyMap>() };

for (auto const& el : map)
{
    std::wcout << el.Key().c_str() << L", " << std::hex << el.Value() << std::endl;
}

IIterator<IKeyValuePair<winrt::hstring, int>> it{ map.First() };
while (it.HasCurrent())
{
    std::wcout << it.Current().Key().c_str() << L", " << std::hex << it.Current().Value() << std::endl;
    it.MoveNext();
}

map_base::Funktion löschen

Entfernt alle Elemente aus dem map_base-Objekt .

Syntax

void Clear() noexcept;

map_base::Erste Funktion

Ruft einen IIterator ab, der das erste Element im map_base-Objekt darstellt.

Syntax

auto First();

Rückgabewert

Ein IIterator , der das erste Element im map_base-Objekt darstellt.

map_base::GetView-Funktion

Ruft eine unveränderliche Ansicht des map_base-Objekts ab.

Syntax

winrt::Windows::Foundation::Collections::IMapView<K, V> GetView() const;

Rückgabewert

Eine IMapView mit einer unveränderlichen Ansicht des map_base.

map_base::HasKey-Funktion

Bestimmt, ob der angegebene Schlüssel zu einem Element im map_base-Objekt gehört.

Syntax

bool HasKey(K const& key) const noexcept;

Parameter

key Der Schlüssel, nach dem gesucht werden soll.

Rückgabewert

true wenn ein Element mit dem Schlüssel gefunden wird, andernfalls false.

map_base::Funktion einfügen

Fügt ein Oder aktualisiert ein Element im map_base-Objekt .

Syntax

bool Insert(K const& key, V const& value);

Parameter

key Der Schlüssel, der dem Element zugeordnet ist, um einzufügen oder zu aktualisieren.

value Der Wert, der eingefügt oder ersetzt werden soll.

Rückgabewert

true wenn ein Element mit dem angegebenen Schlüssel gefunden und aktualisiert wurde; andernfalls false.

map_base::Nachschlagefunktion

Sucht das durch den angegebenen Schlüssel identifizierte Element nach, und ruft den entsprechenden Wert ab.

Syntax

V Lookup(K const& key) const;

Parameter

key Der Schlüssel zum Nachschlagen.

Rückgabewert

Der Wert, der dem Nachschlagen des Schlüssels entspricht, wenn gefunden wird, andernfalls wird eine winrt::hresult_out_of_bounds Ausnahme ausgelöst.

map_base::Remove-Funktion

Entfernt ein Element aus dem map_base-Objekt .

Syntax

void Remove(K const& key);

Parameter

key Der schlüssel, der dem element zugeordnet ist, das entfernt werden soll.

map_base::Size-Funktion

Ruft die Anzahl der Elemente im map_base-Objekt ab.

Syntax

uint32_t Size() const noexcept;

Rückgabewert

Ein Wert, der die Anzahl der Elemente im map_base-Objekt darstellt.

Siehe auch