|
1 |
| ---- |
2 |
| -title: "ATL Collection Classes | Microsoft Docs" |
3 |
| -ms.custom: "" |
4 |
| -ms.date: "11/04/2016" |
5 |
| -ms.reviewer: "" |
6 |
| -ms.suite: "" |
7 |
| -ms.technology: ["cpp-windows"] |
8 |
| -ms.tgt_pltfrm: "" |
9 |
| -ms.topic: "article" |
10 |
| -dev_langs: ["C++"] |
11 |
| -helpviewer_keywords: ["collection classes"] |
12 |
| -ms.assetid: eff95de6-78ef-4212-9d7d-1dacbdd4cc58 |
13 |
| -caps.latest.revision: 12 |
14 |
| -author: "mikeblome" |
15 |
| -ms.author: "mblome" |
16 |
| -manager: "ghogen" |
17 |
| -ms.workload: ["cplusplus"] |
18 |
| ---- |
19 |
| -# Collection Classes |
20 |
| -The following classes provide support for arrays, lists, maps, and also traits methods for helping with comparisons and element access. |
21 |
| - |
22 |
| -- [CAtlArray](../atl/reference/catlarray-class.md) This class implements an array object. |
23 |
| - |
24 |
| -- [CAtlList](../atl/reference/catllist-class.md) This class provides methods for creating and managing a list object. |
25 |
| - |
26 |
| -- [CAtlMap](../atl/reference/catlmap-class.md) This class provides methods for creating and managing a map object. |
27 |
| - |
28 |
| -- [CAutoPtrArray](../atl/reference/cautoptrarray-class.md) This class provides methods useful when constructing an array of smart pointers. |
29 |
| - |
30 |
| -- [CAutoPtrElementTraits](../atl/reference/cautoptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of smart pointers. |
31 |
| - |
32 |
| -- [CAutoPtrList](../atl/reference/cautoptrlist-class.md) This class provides methods useful when constructing a list of smart pointers. |
33 |
| - |
34 |
| -- [CAutoVectorPtrElementTraits](../atl/reference/cautovectorptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of smart pointers using vector new and delete operators. |
35 |
| - |
36 |
| -- [CComQIPtrElementTraits](../atl/reference/ccomqiptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of COM interface pointers. |
37 |
| - |
38 |
| -- [CComSafeArray](../atl/reference/ccomsafearray-class.md) This class is a wrapper for the [SAFEARRAY Data Type](http://msdn.microsoft.com/en-us/9ec8025b-4763-4526-ab45-390c5d8b3b1e) structure. |
39 |
| - |
40 |
| -- [CComSafeArrayBound](../atl/reference/ccomsafearraybound-class.md) This class is a wrapper for a [SAFEARRAYBOUND](http://msdn.microsoft.com/en-us/303a9bdb-71d6-4f14-8747-84cf84936c6d) structure. |
41 |
| - |
42 |
| -- [CComUnkArray](../atl/reference/ccomunkarray-class.md) This class stores **IUnknown** pointers and is designed to be used as a parameter to the [IConnectionPointImpl](../atl/reference/iconnectionpointimpl-class.md) template class. |
43 |
| - |
44 |
| -- [CDefaultCharTraits](../atl/reference/cdefaultchartraits-class.md) This class provides two static functions for converting characters between uppercase and lowercase. |
45 |
| - |
46 |
| -- [CDefaultCompareTraits](../atl/reference/cdefaultcomparetraits-class.md) This class provides default element comparison functions. |
47 |
| - |
48 |
| -- [CDefaultElementTraits](../atl/reference/cdefaultelementtraits-class.md) This class provides default methods and functions for a collection class. |
49 |
| - |
50 |
| -- [CDefaultHashTraits](../atl/reference/cdefaulthashtraits-class.md) This class provides a static function for calculating hash values. |
51 |
| - |
52 |
| -- [CElementTraits](../atl/reference/celementtraits-class.md) This class is used by collection classes to provide methods and functions for moving, copying, comparison, and hashing operations. |
53 |
| - |
54 |
| -- [CElementTraitsBase](../atl/reference/celementtraitsbase-class.md) This class provides default copy and move methods for a collection class. |
55 |
| - |
56 |
| -- [CHeapPtrElementTraits](../atl/reference/cheapptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of heap pointers. |
57 |
| - |
58 |
| -- [CHeapPtrList](../atl/reference/cheapptrlist-class.md) This class provides methods useful when constructing a list of heap pointers. |
59 |
| - |
60 |
| -- [CInterfaceArray](../atl/reference/cinterfacearray-class.md) This class provides methods useful when constructing an array of COM interface pointers. |
61 |
| - |
62 |
| -- [CInterfaceList](../atl/reference/cinterfacelist-class.md) This class provides methods useful when constructing a list of COM interface pointers. |
63 |
| - |
64 |
| -- [CPrimitiveElementTraits](../atl/reference/cprimitiveelementtraits-class.md) This class provides default methods and functions for a collection class composed of primitive data types. |
65 |
| - |
66 |
| -- [CRBMap](../atl/reference/crbmap-class.md) This class represents a mapping structure, using a Red-Black binary tree. |
67 |
| - |
68 |
| -- [CRBMultiMap](../atl/reference/crbmultimap-class.md) This class represents a mapping structure that allows each key to be associated with more than one value, using a Red-Black binary tree. |
69 |
| - |
70 |
| -- [CRBTree](../atl/reference/crbtree-class.md) This class provides methods for creating and utilizing a Red-Black tree. |
71 |
| - |
72 |
| -- [CSimpleArray](../atl/reference/csimplearray-class.md) This class provides methods for managing a simple array. |
73 |
| - |
74 |
| -- [CSimpleArrayEqualHelper](../atl/reference/csimplearrayequalhelper-class.md) This class is a helper for the [CSimpleArray](../atl/reference/csimplearray-class.md) class. |
75 |
| - |
76 |
| -- [CSimpleArrayEqualHelperFalse](../atl/reference/csimplearrayequalhelperfalse-class.md) This class is a helper for the [CSimpleArray](../atl/reference/csimplearray-class.md) class. |
77 |
| - |
78 |
| -- [CSimpleMap](../atl/reference/csimplemap-class.md) This class provides support for a simple mapping array. |
79 |
| - |
80 |
| -- [CSimpleMapEqualHelper](../atl/reference/csimplemapequalhelper-class.md) This class is a helper for the [CSimpleMap](../atl/reference/csimplemap-class.md) class. |
81 |
| - |
82 |
| -- [CSimpleMapEqualHelperFalse](../atl/reference/csimplemapequalhelperfalse-class.md) This class is a helper for the [CSimpleMap](../atl/reference/csimplemap-class.md) class. |
83 |
| - |
84 |
| -- [CStringElementTraits](../atl/reference/cstringelementtraits-class.md) This class provides static functions used by collection classes storing `CString` objects. |
85 |
| - |
86 |
| -- [CStringElementTraitsI](../atl/reference/cstringelementtraitsi-class.md) This class provides static functions related to strings stored in collection class objects. It is similar to [CStringElementTraits](../atl/reference/cstringelementtraits-class.md), but performs case-insensitive comparisons. |
87 |
| - |
88 |
| -- [CStringRefElementTraits](../atl/reference/cstringrefelementtraits-class.md) This class provides static functions related to strings stored in collection class objects. The string objects are dealt with as references. |
89 |
| - |
90 |
| -## Related Articles |
91 |
| - [ATL Collection Classes](../atl/atl-collection-classes.md) |
92 |
| - |
93 |
| -## See Also |
94 |
| - [Class Overview](../atl/atl-class-overview.md) |
95 |
| - [Collection Classes](../atl/atl-collection-classes.md) |
96 |
| - |
| 1 | +--- |
| 2 | +title: "ATL Collection Classes | Microsoft Docs" |
| 3 | +ms.custom: "" |
| 4 | +ms.date: "11/04/2016" |
| 5 | +ms.reviewer: "" |
| 6 | +ms.suite: "" |
| 7 | +ms.technology: ["cpp-windows"] |
| 8 | +ms.tgt_pltfrm: "" |
| 9 | +ms.topic: "reference" |
| 10 | +dev_langs: ["C++"] |
| 11 | +helpviewer_keywords: ["collection classes"] |
| 12 | +ms.assetid: eff95de6-78ef-4212-9d7d-1dacbdd4cc58 |
| 13 | +caps.latest.revision: 12 |
| 14 | +author: "mikeblome" |
| 15 | +ms.author: "mblome" |
| 16 | +manager: "ghogen" |
| 17 | +ms.workload: ["cplusplus"] |
| 18 | +--- |
| 19 | +# Collection Classes |
| 20 | +The following classes provide support for arrays, lists, maps, and also traits methods for helping with comparisons and element access. |
| 21 | + |
| 22 | +- [CAtlArray](../atl/reference/catlarray-class.md) This class implements an array object. |
| 23 | + |
| 24 | +- [CAtlList](../atl/reference/catllist-class.md) This class provides methods for creating and managing a list object. |
| 25 | + |
| 26 | +- [CAtlMap](../atl/reference/catlmap-class.md) This class provides methods for creating and managing a map object. |
| 27 | + |
| 28 | +- [CAutoPtrArray](../atl/reference/cautoptrarray-class.md) This class provides methods useful when constructing an array of smart pointers. |
| 29 | + |
| 30 | +- [CAutoPtrElementTraits](../atl/reference/cautoptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of smart pointers. |
| 31 | + |
| 32 | +- [CAutoPtrList](../atl/reference/cautoptrlist-class.md) This class provides methods useful when constructing a list of smart pointers. |
| 33 | + |
| 34 | +- [CAutoVectorPtrElementTraits](../atl/reference/cautovectorptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of smart pointers using vector new and delete operators. |
| 35 | + |
| 36 | +- [CComQIPtrElementTraits](../atl/reference/ccomqiptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of COM interface pointers. |
| 37 | + |
| 38 | +- [CComSafeArray](../atl/reference/ccomsafearray-class.md) This class is a wrapper for the [SAFEARRAY Data Type](http://msdn.microsoft.com/en-us/9ec8025b-4763-4526-ab45-390c5d8b3b1e) structure. |
| 39 | + |
| 40 | +- [CComSafeArrayBound](../atl/reference/ccomsafearraybound-class.md) This class is a wrapper for a [SAFEARRAYBOUND](http://msdn.microsoft.com/en-us/303a9bdb-71d6-4f14-8747-84cf84936c6d) structure. |
| 41 | + |
| 42 | +- [CComUnkArray](../atl/reference/ccomunkarray-class.md) This class stores **IUnknown** pointers and is designed to be used as a parameter to the [IConnectionPointImpl](../atl/reference/iconnectionpointimpl-class.md) template class. |
| 43 | + |
| 44 | +- [CDefaultCharTraits](../atl/reference/cdefaultchartraits-class.md) This class provides two static functions for converting characters between uppercase and lowercase. |
| 45 | + |
| 46 | +- [CDefaultCompareTraits](../atl/reference/cdefaultcomparetraits-class.md) This class provides default element comparison functions. |
| 47 | + |
| 48 | +- [CDefaultElementTraits](../atl/reference/cdefaultelementtraits-class.md) This class provides default methods and functions for a collection class. |
| 49 | + |
| 50 | +- [CDefaultHashTraits](../atl/reference/cdefaulthashtraits-class.md) This class provides a static function for calculating hash values. |
| 51 | + |
| 52 | +- [CElementTraits](../atl/reference/celementtraits-class.md) This class is used by collection classes to provide methods and functions for moving, copying, comparison, and hashing operations. |
| 53 | + |
| 54 | +- [CElementTraitsBase](../atl/reference/celementtraitsbase-class.md) This class provides default copy and move methods for a collection class. |
| 55 | + |
| 56 | +- [CHeapPtrElementTraits](../atl/reference/cheapptrelementtraits-class.md) This class provides methods, static functions, and typedefs useful when creating collections of heap pointers. |
| 57 | + |
| 58 | +- [CHeapPtrList](../atl/reference/cheapptrlist-class.md) This class provides methods useful when constructing a list of heap pointers. |
| 59 | + |
| 60 | +- [CInterfaceArray](../atl/reference/cinterfacearray-class.md) This class provides methods useful when constructing an array of COM interface pointers. |
| 61 | + |
| 62 | +- [CInterfaceList](../atl/reference/cinterfacelist-class.md) This class provides methods useful when constructing a list of COM interface pointers. |
| 63 | + |
| 64 | +- [CPrimitiveElementTraits](../atl/reference/cprimitiveelementtraits-class.md) This class provides default methods and functions for a collection class composed of primitive data types. |
| 65 | + |
| 66 | +- [CRBMap](../atl/reference/crbmap-class.md) This class represents a mapping structure, using a Red-Black binary tree. |
| 67 | + |
| 68 | +- [CRBMultiMap](../atl/reference/crbmultimap-class.md) This class represents a mapping structure that allows each key to be associated with more than one value, using a Red-Black binary tree. |
| 69 | + |
| 70 | +- [CRBTree](../atl/reference/crbtree-class.md) This class provides methods for creating and utilizing a Red-Black tree. |
| 71 | + |
| 72 | +- [CSimpleArray](../atl/reference/csimplearray-class.md) This class provides methods for managing a simple array. |
| 73 | + |
| 74 | +- [CSimpleArrayEqualHelper](../atl/reference/csimplearrayequalhelper-class.md) This class is a helper for the [CSimpleArray](../atl/reference/csimplearray-class.md) class. |
| 75 | + |
| 76 | +- [CSimpleArrayEqualHelperFalse](../atl/reference/csimplearrayequalhelperfalse-class.md) This class is a helper for the [CSimpleArray](../atl/reference/csimplearray-class.md) class. |
| 77 | + |
| 78 | +- [CSimpleMap](../atl/reference/csimplemap-class.md) This class provides support for a simple mapping array. |
| 79 | + |
| 80 | +- [CSimpleMapEqualHelper](../atl/reference/csimplemapequalhelper-class.md) This class is a helper for the [CSimpleMap](../atl/reference/csimplemap-class.md) class. |
| 81 | + |
| 82 | +- [CSimpleMapEqualHelperFalse](../atl/reference/csimplemapequalhelperfalse-class.md) This class is a helper for the [CSimpleMap](../atl/reference/csimplemap-class.md) class. |
| 83 | + |
| 84 | +- [CStringElementTraits](../atl/reference/cstringelementtraits-class.md) This class provides static functions used by collection classes storing `CString` objects. |
| 85 | + |
| 86 | +- [CStringElementTraitsI](../atl/reference/cstringelementtraitsi-class.md) This class provides static functions related to strings stored in collection class objects. It is similar to [CStringElementTraits](../atl/reference/cstringelementtraits-class.md), but performs case-insensitive comparisons. |
| 87 | + |
| 88 | +- [CStringRefElementTraits](../atl/reference/cstringrefelementtraits-class.md) This class provides static functions related to strings stored in collection class objects. The string objects are dealt with as references. |
| 89 | + |
| 90 | +## Related Articles |
| 91 | + [ATL Collection Classes](../atl/atl-collection-classes.md) |
| 92 | + |
| 93 | +## See Also |
| 94 | + [Class Overview](../atl/atl-class-overview.md) |
| 95 | + [Collection Classes](../atl/atl-collection-classes.md) |
| 96 | + |
0 commit comments