CHeapPtr< T, Allocator > Class Template Reference

#include <atlalloc.h>

Inheritance diagram for CHeapPtr< T, Allocator >:

Public Member Functions
	CHeapPtr ()
	CHeapPtr (T *lp)
	CHeapPtr (CHeapPtr< T, Allocator > &lp)
	~CHeapPtr ()
CHeapPtr< T, Allocator > &	operator= (CHeapPtr< T, Allocator > &lp)
bool	AllocateBytes (_In_ size_t nBytes)
bool	ReallocateBytes (_In_ size_t nBytes)
bool	Allocate (_In_ size_t nElements=1)
bool	Reallocate (_In_ size_t nElements)
void	Free ()
void	Attach (T *lp)
T *	Detach ()
T **	operator& ()
	operator T* () const
T *	operator-> () const

Public Attributes
T *	m_pData

Detailed Description

template<class T, class Allocator = CCRTAllocator>
class CHeapPtr< T, Allocator >

Definition at line 97 of file atlalloc.h.

Constructor & Destructor Documentation

CHeapPtr() [1/3]

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator >::CHeapPtr ( )

inline

Definition at line 100 of file atlalloc.h.

               :
        m_pData(NULL)
    {
    }

CHeapPtr() [2/3]

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator >::CHeapPtr ( T *  lp )

inlineexplicit

Definition at line 105 of file atlalloc.h.

                             :
        m_pData(lp)
    {
    }

CHeapPtr() [3/3]

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator >::CHeapPtr ( CHeapPtr< T, Allocator > &  lp )

inlineexplicit

Definition at line 110 of file atlalloc.h.

    {
        m_pData = lp.Detach();
    }

~CHeapPtr()

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator >::~CHeapPtr ( )

inline

Definition at line 115 of file atlalloc.h.

    {
        Free();
    }

Member Function Documentation

Allocate()

template<class T , class Allocator = CCRTAllocator>

bool CHeapPtr< T, Allocator >::Allocate ( _In_ size_t  nElements = 1 )

inline

Definition at line 143 of file atlalloc.h.

    {
        return AllocateBytes(nElements * sizeof(T));
    }

Referenced by dde_connect(), CAddressEditBox::GetComboBoxText(), CFindFolder::GetUIObjectOf(), CIniPropertyBag::Read(), SHELL_BuildEnvW(), SHELL_execute(), SHELL_execute_url(), SHELL_quote_and_execute(), and TRASH_PlayEmptyRecycleBinSound().

AllocateBytes()

template<class T , class Allocator = CCRTAllocator>

bool CHeapPtr< T, Allocator >::AllocateBytes ( _In_ size_t  nBytes )

inline

Definition at line 127 of file atlalloc.h.

    {
        ATLASSERT(m_pData == NULL);
        m_pData = static_cast<T*>(Allocator::Allocate(nBytes));
        return m_pData != NULL;
    }

Referenced by CHeapPtr< T, Allocator >::Allocate(), and CopyStreamUI().

Attach()

template<class T , class Allocator = CCRTAllocator>

void CHeapPtr< T, Allocator >::Attach ( T *  lp )

inline

Definition at line 162 of file atlalloc.h.

    {
        Allocator::Free(m_pData);
        m_pData = lp;
    }

Referenced by InstallFontFiles(), CSendToMenu::LoadAllItems(), CZipExtract::CExtractSettingsPage::OnBrowse(), CHeapPtr< T, Allocator >::operator=(), CFolder::ParseName(), SHELL_execute(), shellex_get_dataobj(), SHOpenFolderAndSelectItems(), and TRASH_PlayEmptyRecycleBinSound().

Detach()

template<class T , class Allocator = CCRTAllocator>

T * CHeapPtr< T, Allocator >::Detach ( )

inline

Definition at line 168 of file atlalloc.h.

    {
        T *saveP = m_pData;
        m_pData = NULL;
        return saveP;
    }

Referenced by CShellBrowser::BrowseToPath(), CHeapPtr< T, Allocator >::CHeapPtr(), CACListISF::Expand(), CSendToMenu::GetSpecialFolder(), CSendToMenu::LoadAllItems(), CACListISF::Next(), CACListISF::NextLocation(), CSearchBar::OnSearchButtonClicked(), CHeapPtr< T, Allocator >::operator=(), CAddressEditBox::RefreshAddress(), CACListISF::Reset(), and SHELL_BuildEnvW().

Free()

template<class T , class Allocator = CCRTAllocator>

void CHeapPtr< T, Allocator >::Free ( )

inline

Definition at line 153 of file atlalloc.h.

    {
        if (m_pData)
        {
            Allocator::Free(m_pData);
            m_pData = NULL;
        }
    }

Referenced by BrFolder_Expand(), BrFolder_IsTreeItemInEnum(), BrFolder_RefreshRecurse(), CFolderItems::get_Count(), CAddressEditBox::GetComboBoxText(), CACListISF::GetDisplayName(), CACListISF::Next(), and CHeapPtr< T, Allocator >::~CHeapPtr().

operator T*()

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator >::operator T* ( ) const

inline

Definition at line 181 of file atlalloc.h.

    {
        return m_pData;
    }

operator&()

template<class T , class Allocator = CCRTAllocator>

T ** CHeapPtr< T, Allocator >::operator& ( )

inline

Definition at line 175 of file atlalloc.h.

    {
        ATLASSERT(m_pData == NULL);
        return &m_pData;
    }

operator->()

template<class T , class Allocator = CCRTAllocator>

T * CHeapPtr< T, Allocator >::operator-> ( ) const

inline

Definition at line 186 of file atlalloc.h.

    {
        return m_pData;
    }

operator=()

template<class T , class Allocator = CCRTAllocator>

CHeapPtr< T, Allocator > & CHeapPtr< T, Allocator >::operator= ( CHeapPtr< T, Allocator > &  lp )

inline

Definition at line 120 of file atlalloc.h.

    {
        if (lp.m_pData != m_pData)
            Attach(lp.Detach());
        return *this;
    }

Reallocate()

template<class T , class Allocator = CCRTAllocator>

bool CHeapPtr< T, Allocator >::Reallocate ( _In_ size_t  nElements )

inline

Definition at line 148 of file atlalloc.h.

    {
        return ReallocateBytes(nElements * sizeof(T));
    }

ReallocateBytes()

template<class T , class Allocator = CCRTAllocator>

bool CHeapPtr< T, Allocator >::ReallocateBytes ( _In_ size_t  nBytes )

inline

Definition at line 134 of file atlalloc.h.

    {
        T* newData = static_cast<T*>(Allocator::Reallocate(m_pData, nBytes));
        if (newData == NULL)
            return false;
        m_pData = newData;
        return true;
    }

Referenced by CHeapPtr< T, Allocator >::Reallocate().

Member Data Documentation

m_pData

template<class T , class Allocator = CCRTAllocator>

T* CHeapPtr< T, Allocator >::m_pData

Definition at line 192 of file atlalloc.h.

Referenced by CHeapPtr< T, Allocator >::AllocateBytes(), CHeapPtr< T, Allocator >::Attach(), CHeapPtr< T, Allocator >::CHeapPtr(), CHeapPtr< T, Allocator >::Detach(), CHeapPtr< T, Allocator >::Free(), CHeapPtr< _ITEMIDLIST_ABSOLUTE, CComAllocator >::operator _ITEMIDLIST_ABSOLUTE *(), CHeapPtr< T, Allocator >::operator&(), CHeapPtr< T, Allocator >::operator->(), CHeapPtr< T, Allocator >::operator=(), CHeapPtr< T, Allocator >::ReallocateBytes(), and START_TEST().

---

The documentation for this class was generated from the following file:

• sdk/lib/atl/atlalloc.h