Platform::Collections::Map Class

0 out of 2 rated this helpful - Rate this topic

Represents a map, which is a collection of key-value pairs.

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

Parameters

K: The type of the key in the key-value pair.
V: The type of the value in the key-value pair.
C: A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. By default, std::less<K>.

Remarks

Allowed types are:

integers
interface class ^
public ref class^
value struct
public enum class

Map is the C++ concrete implementation of the Windows::Foundation::Collections::IMap and IObservableMap types that is passed across public Windows Runtime interfaces. If you try to use a Map type in a public return value or parameter, compiler error C3986 is raised. You can fix the error by changing the type of the parameter or return value to Windows::Foundation::Collections::IMap.

For more information, see Collections (C++/CX).

Members

Public Constructors

Name	Description
Map::Map Constructor	Initializes a new instance of the Map class.

Public Methods

Name	Description
Map::Clear Method	Removes all key-value pairs from the current Map object.
Map::First Method	Returns an iterator that specifies the first element in the map.
Map::GetView Method	Returns a read-only view of the current Map; that is, a Platform::Collections::MapView Class.
Map::HasKey Method	Determines whether the current Map contains the specified key.
Map::Insert Method	Adds the specified key-value pair to the current Map object.
Map::Lookup Method	Retrieves the element at the specified key in the current Map object.
Map::Remove Method	Deletes the specified key-value pair from the current Map object.
Map::Size Method	Returns the number of elements in the current Map object.

Events

Name	Description
event Windows::Foundation::Collections::MapChangedEventHandler<K, V>^ MapChanged	Occurs when the Map changes.

Inheritance Hierarchy

Map

Requirements

Header: collection.h

Namespace: Platform::Collections

Concepts

Creating Windows Runtime Components in C++

Other Resources

Platform Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)