Platform::Collections::Map 클래스Platform::Collections::Map Class

키/값 쌍의 컬렉션인 을 나타냅니다.Represents a map, which is a collection of key-value pairs. XAML 데이터 바인딩을지원 하기 위해 Windows:: Foundation:: Collections:: IObservableMap 을 구현 합니다.Implements Windows::Foundation::Collections::IObservableMap to help with XAML data binding.

구문Syntax

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.

Hyper-vV
키/값 쌍의 값 형식입니다.The type of the value in the key-value pair.

CC
두 요소 값을 정렬 키로 비교하여 맵에서 해당 상대 순서를 확인할 수 있는 함수 개체를 제공하는 형식입니다.A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. 기본적으로 std:: less <K> 입니다.By default, std::less<K>.

__is_valid_winrt_type () KV 형식의 유효성을 검사 하 고 해당 형식을 맵에 저장할 수 없는 경우 친숙 한 오류 메시지를 제공 하는 컴파일러 생성 함수입니다.__is_valid_winrt_type() A compiler-generated function that validates the type of K and V and provides a friendly error message if the type cannot be stored in the Map.

설명Remarks

허용 유형은 다음과 같습니다.Allowed types are:

  • integersintegers

  • 인터페이스 클래스 ^interface class^

  • public ref 클래스 ^public ref class^

  • value structvalue struct

  • public enum 클래스public enum class

Map은 기본적으로 std::map에 대한 래퍼입니다.Map is basically a wrapper for std::map. 공용 Windows 런타임 인터페이스를 통해 전달 되는 Windows:: Foundation:: Collections:: IMap <Windows::Foundation::Collections::IKeyValuePair<K,V> > IObservableMap 형식에 대 한 c + +의 구체적인 구현입니다.It is a C++ concrete implementation of the Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> and IObservableMap types that are passed across public Windows Runtime interfaces. 공용 반환 값 또는 매개 변수에서 Platform::Collections::Map 형식을 사용하려고 하면 컴파일러 오류 C3986이 발생합니다.If you try to use a Platform::Collections::Map type in a public return value or parameter, compiler error C3986 is raised. 매개 변수 또는 반환 값의 형식을 Windows:: Foundation:: Collections:: IMap <K,V> 으로 변경 하 여 오류를 해결할 수 있습니다.You can fix the error by changing the type of the parameter or return value to Windows::Foundation::Collections::IMap<K,V>.

자세한 내용은 컬렉션을 참조 하세요.For more information, see Collections.

멤버Members

Public 생성자Public Constructors

이름Name 설명Description
Map:: MapMap::Map Map 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Map class.

Public 메서드Public Methods

이름Name 설명Description
Map:: ClearMap::Clear 현재 Map 개체에서 모든 키/값 쌍을 제거합니다.Removes all key-value pairs from the current Map object.
Map:: FirstMap::First 맵의 첫 번째 요소를 지정하는 반복기를 반환합니다.Returns an iterator that specifies the first element in the map.
Map:: GetViewMap::GetView 현재 Map의 읽기 전용 보기, 즉 Platform::Collections::MapView Class를 반환합니다.Returns a read-only view of the current Map; that is, a Platform::Collections::MapView Class.
Map:: HasKeyMap::HasKey 현재 Map에 지정한 키가 들어 있는지 여부를 확인합니다.Determines whether the current Map contains the specified key.
Map:: InsertMap::Insert 지정한 키/값 쌍을 현재 Map 개체에 추가합니다.Adds the specified key-value pair to the current Map object.
Map:: LookupMap::Lookup 현재 Map 개체의 지정된 키에 있는 요소를 검색합니다.Retrieves the element at the specified key in the current Map object.
Map::RemoveMap::Remove 지정한 키/값 쌍을 현재 Map 개체에서 삭제합니다.Deletes the specified key-value pair from the current Map object.
Map:: SizeMap::Size 현재 Map 개체의 요소 수를 반환합니다.Returns the number of elements in the current Map object.

이벤트Events

NameName 설명Description
Map:: MapChanged 이벤트Map::MapChanged event Map이 변경될 때 발생합니다.Occurs when the Map changes.

상속 계층 구조Inheritance Hierarchy

Map

요구 사항Requirements

헤더: collection .hHeader: collection.h

네임스페이스: Platform::CollectionsNamespace: Platform::Collections

Map:: Clear 메서드Map::Clear Method

현재 Map 개체에서 모든 키/값 쌍을 제거합니다.Removes all key-value pairs from the current Map object.

구문Syntax

virtual void Clear();

Map:: First 메서드Map::First Method

Map의 첫 번째 요소를 지정 하는 반복기를 반환 하거나 nullptr map이 비어 있는 경우을 반환 합니다.Returns an iterator that specifies the first element in the map, or nullptr if the map is empty.

구문Syntax

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

Return ValueReturn Value

맵의 첫 번째 요소를 지정하는 반복기입니다.An iterator that specifies the first element in the map.

설명Remarks

First ()에서 반환 된 반복기를 편리 하 게 유지 하는 방법은 형식 추론 키워드를 사용 하 여 선언 된 변수에 반환 값을 할당 하는 것입니다 auto .A convenient way to hold the iterator returned by First() is to assign the return value to a variable that is declared with the auto type deduction keyword. 예: auto x = myMap->First();.For example, auto x = myMap->First();.

Map:: GetView 메서드Map::GetView Method

현재 지도의 읽기 전용 뷰를 반환 합니다. 즉, Windows:: Foundation:: collections:: IMapView <K,V> 인터페이스를 구현 하는 Platform:: Collections:: mapview 클래스입니다.Returns a read-only view of the current Map; that is, a Platform::Collections::MapView Class, which implements the Windows::Foundation::Collections::IMapView<K,V> interface.

구문Syntax

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

Return ValueReturn Value

MapView 개체입니다.A MapView object.

Map:: HasKey 메서드Map::HasKey Method

현재 Map에 지정한 키가 들어 있는지 여부를 확인합니다.Determines whether the current Map contains the specified key.

구문Syntax

bool HasKey(K key);

매개 변수Parameters

keykey
Map 요소를 찾는 데 사용되는 키입니다.The key used to locate the Map element. 의 형식은 형식 이름 K입니다.The type of key is typename K.

반환 값Return Value

true 키가 있으면이 고, 그렇지 않으면입니다. 그렇지 않으면 false 입니다.true if the key is found; otherwise, false.

Map:: Insert 메서드Map::Insert Method

지정한 키/값 쌍을 현재 Map 개체에 추가합니다.Adds the specified key-value pair to the current Map object.

구문Syntax

virtual bool Insert(K key, V value);

매개 변수Parameters

keykey
키-값 쌍의 키 부분입니다.The key portion of the key-value pair. 의 형식은 형식 이름 K입니다.The type of key is typename K.

valuevalue
키-값 쌍의 값 부분입니다.The value portion of the key-value pair. 의 형식은 형식 이름 V입니다.The type of value is typename V.

반환 값Return Value

true 현재 Map의 기존 요소 키가 와 일치 하 고 해당 요소의 값 부분이 value로 설정 되어 있으면입니다.true if the key of an existing element in the current Map matches key and the value portion of that element is set to value. false 현재 Map의 기존 요소가 와 일치 하지 않고 키 및 매개 변수가 키-값 쌍으로 만들어진 다음 현재 맵에 추가 되는 경우입니다.false if no existing element in the current Map matches key and the key and value parameters are made into a key-value pair and then added to the current Map.

Map:: Lookup 메서드Map::Lookup Method

K 형식의 지정된 키(해당 키가 있는 경우)와 연결된 V 형식의 값을 검색합니다.Retrieves the value of type V that is associated with the specified key of type K, if the key exists.

구문Syntax

V Lookup(K key);

매개 변수Parameters

keykey
지도에서 요소를 찾는 데 사용되는 키입니다.The key used to locate an element in the Map. 의 형식은 형식 이름 K입니다.The type of key is typename K.

반환 값Return Value

와 쌍으로 연결 된 값입니다.The value that is paired with the key. 반환 값의 형식은 형식 이름 V입니다.The type of the return value is typename V.

설명Remarks

키가 없으면 Platform:: OutOfBoundsException 이 throw 됩니다.If the key does not exist, then a Platform::OutOfBoundsException is thrown.

Map:: Map 생성자Map::Map Constructor

Map 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Map class.

구문Syntax

explicit Map(const C& comp = C());
explicit Map(const StdMap& m);
explicit Map(StdMap&& m ;
template <typename InIt>
Map(
   InItfirst,
   InItlast,
   const C& comp = C());

매개 변수Parameters

Cloud-initInIt
현재 Map의 형식 이름입니다.The typename of the current Map.

compcomp
두 요소 값을 정렬 키로 비교하여 맵에서 해당 상대 순서를 확인할 수 있는 함수 개체를 제공하는 형식입니다.A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map.

mm
현재 Map을 초기화 하는 데 사용 되는에 대 한 참조 또는 rvalue 입니다 map Class .A reference or rvalue to a map Class that is used to initialize the current Map.

firstfirst
현재 Map를 초기화하는 데 사용되는 요소 범위에서 첫 번째 요소의 입력 반복기입니다.The input iterator of the first element in a range of elements used to initialize the current Map.

lastlast
현재 Map를 초기화하는 데 사용되는 요소 범위 다음의 첫 번째 요소의 입력 반복기입니다.The input iterator of the first element after a range of elements used to initialize the current Map.

Map:: MapChanged 이벤트Map::MapChanged Event

맵에서 항목이 삽입되거나 제거될 때 발생합니다.Raised when an item is inserted into or removed from the map.

구문Syntax

event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;

속성 값/반환 값Property Value/Return Value

이벤트를 발생 시킨 개체에 대 한 정보 및 발생 한 변경 내용의 종류를 포함 하는 Mapchangedeventhandler <K,V> 입니다.A MapChangedEventHandler<K,V> that contains information about the object that raised the event, and the kind of change that occurred. Imapchangedeventargs&lt <K> collectionchange 열거도 참조 하세요.See also IMapChangedEventArgs<K> and CollectionChange Enumeration.

.NET Framework의 해당 값.NET Framework Equivalent

C #을 사용 하거나 project IMap을 IDictionary로 Visual Basic 하는 앱을 Windows 런타임 <K,V> <K,V> 합니다.Windows Runtime apps that use C# or Visual Basic project IMap<K,V> as IDictionary<K,V>.

Map:: Remove 메서드Map::Remove Method

지정한 키/값 쌍을 현재 Map 개체에서 삭제합니다.Deletes the specified key-value pair from the current Map object.

구문Syntax

virtual void Remove(K key);

매개 변수Parameters

keykey
키-값 쌍의 키 부분입니다.The key portion of the key-value pair. 의 형식은 형식 이름 K입니다.The type of key is typename K.

Map:: Size 메서드Map::Size Method

맵의 Windows:: Foundation:: Collections:: inputiterator<ikeyvaluepair<k <K,V> 요소 수를 반환 합니다.Returns the number of Windows::Foundation::Collections::IKeyValuePair<K,V> elements in the Map.

구문Syntax

virtual property unsigned int Size;

Return ValueReturn Value

Map의 요소 수입니다.The number of elements in the Map.

참고 항목See also

컬렉션 (c + +/CX)Collections (C++/CX)
Platform 네임 스페이스Platform Namespace
C++로 Windows Runtime 구성 요소 만들기Creating Windows Runtime Components in C++