CHeapPtrList Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CHeapPtrList Class.

This class provides methods useful when constructing a list of heap pointers.

System_CAPS_ICON_important.jpg Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

template<typename E, class Allocator = ATL::CCRTAllocator>  
class CHeapPtrList 
   : public CAtlList<ATL::CHeapPtr<E, Allocator>,
                     CHeapPtrElementTraits<E, Allocator>>

Parameters

E
The object type to be stored in the collection class.

Allocator
The memory allocation class to use. The default is CCRTAllocator.

Public Constructors

NameDescription
CHeapPtrList::CHeapPtrListThe constructor.

This class provides a constructor and derives methods from CAtlList and CHeapPtrElementTraits to aid the creation of a collection class object storing heap pointers.

CAtlList

CHeapPtrList

Header: atlcoll.h

The constructor.

CHeapPtrList(UINT nBlockSize = 10) throw();

Parameters

nBlockSize
The block size.

Remarks

The block size is a measure of the amount of memory allocated when a new element is required. Larger block sizes reduce calls to memory allocation routines, but use more resources.

CAtlList Class
CHeapPtr Class
CHeapPtrElementTraits Class
Class Overview

Show: