ATL::CSimpleStringT< BaseType, t_bMFCDLL > Class Template Reference

#include <atlsimpstr.h>

Public Types
typedef ChTraitsBase< BaseType >::XCHAR	XCHAR
typedef ChTraitsBase< BaseType >::PXSTR	PXSTR
typedef ChTraitsBase< BaseType >::PCXSTR	PCXSTR
typedef ChTraitsBase< BaseType >::YCHAR	YCHAR
typedef ChTraitsBase< BaseType >::PYSTR	PYSTR
typedef ChTraitsBase< BaseType >::PCYSTR	PCYSTR

Public Member Functions
	CSimpleStringT (_Inout_ IAtlStringMgr *pStringMgr)
	CSimpleStringT (_In_ const CSimpleStringT &strSrc)
	CSimpleStringT (_In_z_ PCXSTR pszSrc, _Inout_ IAtlStringMgr *pStringMgr)
	CSimpleStringT (_In_count_(nLength) const XCHAR *pchSrc, _In_ int nLength, _Inout_ IAtlStringMgr *pStringMgr)
	~CSimpleStringT () throw ()
CSimpleStringT &	operator= (_In_opt_z_ PCXSTR pszSrc)
CSimpleStringT &	operator= (_In_ const CSimpleStringT &strSrc)
CSimpleStringT &	operator+= (_In_ const CSimpleStringT &strSrc)
CSimpleStringT &	operator+= (_In_z_ PCXSTR pszSrc)
CSimpleStringT &	operator+= (XCHAR ch)
	operator PCXSTR () const throw ()
void	Empty () throw ()
void	Append (_In_count_(nLength) PCXSTR pszSrc, _In_ int nLength)
void	Append (_In_z_ PCXSTR pszSrc)
void	Append (_In_ const CSimpleStringT &strSrc)
void	SetString (_In_opt_z_ PCXSTR pszSrc)
void	SetString (_In_reads_opt_(nLength) PCXSTR pszSrc, _In_ int nLength)
PXSTR	GetBuffer ()
_Ret_notnull_	_Post_writable_size_ (nMinBufferLength+1) PXSTR GetBuffer(_In_ int nMinBufferLength)
int	GetAllocLength () const throw ()
int	GetLength () const throw ()
PCXSTR	GetString () const throw ()
void	ReleaseBufferSetLength (_In_ int nNewLength)
void	ReleaseBuffer (_In_ int nNewLength=-1)
bool	IsEmpty () const throw ()
CStringData *	GetData () const throw ()
IAtlStringMgr *	GetManager () const throw ()

Static Public Member Functions
static void __cdecl	CopyChars (_Out_writes_to_(nDestLen, nChars) XCHAR *pchDest, _In_ size_t nDestLen, _In_reads_opt_(nChars) const XCHAR *pchSrc, _In_ int nChars) throw ()
static void __cdecl	CopyCharsOverlapped (_Out_writes_to_(nDestLen, nDestLen) XCHAR *pchDest, _In_ size_t nDestLen, _In_reads_(nChars) const XCHAR *pchSrc, _In_ int nChars) throw ()
static int __cdecl	StringLength (_In_opt_z_ const char *psz) throw ()
static int __cdecl	StringLength (_In_opt_z_ const wchar_t *psz) throw ()

Static Protected Member Functions
static void __cdecl	Concatenate (_Inout_ CSimpleStringT &strResult, _In_count_(nLength1) PCXSTR psz1, _In_ int nLength1, _In_count_(nLength2) PCXSTR psz2, _In_ int nLength2)
static void	ThrowMemoryException ()
static void	ThrowInvalidArgException ()

Private Member Functions
void	Attach (_Inout_ CStringData *pData) throw ()
	__declspec (noinline) void Fork(_In_ int nLength)
PXSTR	PrepareWrite (_In_ int nLength)
void	PrepareWrite2 (_In_ int nLength)
void	Reallocate (_In_ int nLength)
void	SetLength (_In_ int nLength)

Static Private Member Functions
static CStringData *__cdecl	CloneData (_Inout_ CStringData *pData)

Private Attributes
PXSTR	m_pszData

Friends
CSimpleStringT	operator+ (_In_ const CSimpleStringT &str1, _In_ const CSimpleStringT &str2)
CSimpleStringT	operator+ (_In_ const CSimpleStringT &str1, _In_z_ PCXSTR psz2)
CSimpleStringT	operator+ (_In_z_ PCXSTR psz1, _In_ const CSimpleStringT &str2)

Detailed Description

template<typename BaseType, bool t_bMFCDLL = false>
class ATL::CSimpleStringT< BaseType, t_bMFCDLL >

Definition at line 131 of file atlsimpstr.h.

Member Typedef Documentation

PCXSTR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::PCXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PCXSTR

Definition at line 136 of file atlsimpstr.h.

PCYSTR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::PCYSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PCYSTR

Definition at line 139 of file atlsimpstr.h.

PXSTR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::PXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PXSTR

Definition at line 135 of file atlsimpstr.h.

PYSTR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::PYSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PYSTR

Definition at line 138 of file atlsimpstr.h.

XCHAR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::XCHAR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::XCHAR

Definition at line 134 of file atlsimpstr.h.

YCHAR

template<typename BaseType, bool t_bMFCDLL = false>

typedef ChTraitsBase<BaseType>::YCHAR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::YCHAR

Definition at line 137 of file atlsimpstr.h.

Constructor & Destructor Documentation

CSimpleStringT() [1/4]

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT ( _Inout_ IAtlStringMgr *  pStringMgr )

inlineexplicit

Definition at line 145 of file atlsimpstr.h.

    {
        CStringData* pData = pStringMgr->GetNilString();
        Attach(pData);
    }

CSimpleStringT() [2/4]

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 151 of file atlsimpstr.h.

    {
        CStringData* pSrcData = strSrc.GetData();
        CStringData* pNewData = CloneData(pSrcData);
        Attach(pNewData);
    }

CSimpleStringT() [3/4]

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT ( _In_z_ PCXSTR  pszSrc, _Inout_ IAtlStringMgr *  pStringMgr  )

inline

Definition at line 158 of file atlsimpstr.h.

    {
        int nLength = StringLength(pszSrc);
        CStringData* pData = pStringMgr->Allocate(nLength, sizeof(XCHAR));
        if (pData == NULL)
            ThrowMemoryException();

        Attach(pData);
        SetLength(nLength);
        CopyChars(m_pszData, nLength, pszSrc, nLength);
    }

CSimpleStringT() [4/4]

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT ( _In_count_(nLength) const XCHAR *  pchSrc, _In_ int  nLength, _Inout_ IAtlStringMgr *  pStringMgr  )

inline

Definition at line 172 of file atlsimpstr.h.

    {
        if (pchSrc == NULL && nLength != 0)
            ThrowInvalidArgException();

        CStringData* pData = pStringMgr->Allocate(nLength, sizeof(XCHAR));
        if (pData == NULL)
        {
            ThrowMemoryException();
        }
        Attach(pData);
        SetLength(nLength);
        CopyChars(m_pszData, nLength, pchSrc, nLength);
    }

~CSimpleStringT()

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::~CSimpleStringT ( ) throw ( )

inline

Definition at line 190 of file atlsimpstr.h.

    {
        CStringData* pData = GetData();
        pData->Release();
    }

Member Function Documentation

__declspec()

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::__declspec ( noinline  )

inlineprivate

Definition at line 493 of file atlsimpstr.h.

    {
        CStringData* pOldData = GetData();
        int nOldLength = pOldData->nDataLength;
        CStringData* pNewData = pOldData->pStringMgr->Clone()->Allocate(nLength, sizeof(XCHAR));
        if (pNewData == NULL)
        {
            ThrowMemoryException();
        }
        int nCharsToCopy = ((nOldLength < nLength) ? nOldLength : nLength) + 1;
        CopyChars(PXSTR(pNewData->data()), nCharsToCopy,
                  PCXSTR(pOldData->data()), nCharsToCopy);
        pNewData->nDataLength = nOldLength;
        pOldData->Release();
        Attach(pNewData);
    }

_Post_writable_size_()

template<typename BaseType, bool t_bMFCDLL = false>

_Ret_notnull_ ATL::CSimpleStringT< BaseType, t_bMFCDLL >::_Post_writable_size_ ( nMinBufferLength+  1 )

inline

Definition at line 346 of file atlsimpstr.h.

    {
        return PrepareWrite(nMinBufferLength);
    }

Append() [1/3]

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append ( _In_count_(nLength) PCXSTR  pszSrc, _In_ int  nLength  )

inline

Definition at line 265 of file atlsimpstr.h.

    {
        UINT_PTR nOffset = pszSrc - GetString();

        int nOldLength = GetLength();
        if (nOldLength < 0)
            nOldLength = 0;

        ATLASSERT(nLength >= 0);

#if 0 // FIXME: See comment for StringLengthN below.
        nLength = StringLengthN(pszSrc, nLength);
        if (!(INT_MAX - nLength >= nOldLength))
            throw;
#endif

        int nNewLength = nOldLength + nLength;
        PXSTR pszBuffer = GetBuffer(nNewLength);
        if (nOffset <= (UINT_PTR)nOldLength)
        {
            pszSrc = pszBuffer + nOffset;
        }
        CopyChars(pszBuffer + nOldLength, nLength, pszSrc, nLength);
        ReleaseBufferSetLength(nNewLength);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator+=().

Append() [2/3]

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append ( _In_z_ PCXSTR  pszSrc )

inline

Definition at line 293 of file atlsimpstr.h.

    {
        Append(pszSrc, StringLength(pszSrc));
    }

Append() [3/3]

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 298 of file atlsimpstr.h.

    {
        Append(strSrc.GetString(), strSrc.GetLength());
    }

Attach()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Attach ( _Inout_ CStringData *  pData ) throw ( )

inlineprivate

Definition at line 488 of file atlsimpstr.h.

    {
        m_pszData = static_cast<PXSTR>(pData->data());
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::__declspec(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Empty(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator=(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Reallocate().

CloneData()

template<typename BaseType, bool t_bMFCDLL = false>

static CStringData* __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CloneData ( _Inout_ CStringData *  pData )

inlinestaticprivate

Definition at line 585 of file atlsimpstr.h.

    {
        CStringData* pNewData = NULL;

        IAtlStringMgr* pNewStringMgr = pData->pStringMgr->Clone();
        if (!pData->IsLocked() && (pNewStringMgr == pData->pStringMgr))
        {
            pNewData = pData;
            pNewData->AddRef();
        }
        else
        {
            pNewData = pNewStringMgr->Allocate(pData->nDataLength, sizeof(XCHAR));
            if (pNewData == NULL)
            {
                ThrowMemoryException();
            }

            pNewData->nDataLength = pData->nDataLength;
            CopyChars(PXSTR(pNewData->data()), pData->nDataLength + 1,
                      PCXSTR(pData->data()), pData->nDataLength + 1);
        }

        return pNewData;
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator=().

Concatenate()

template<typename BaseType, bool t_bMFCDLL = false>

static void __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Concatenate ( _Inout_ CSimpleStringT< BaseType, t_bMFCDLL > &  strResult, _In_count_(nLength1) PCXSTR  psz1, _In_ int  nLength1, _In_count_(nLength2) PCXSTR  psz2, _In_ int  nLength2  )

inlinestaticprotected

Definition at line 473 of file atlsimpstr.h.

    {
        int nNewLength = nLength1 + nLength2;
        PXSTR pszBuffer = strResult.GetBuffer(nNewLength);
        CopyChars(pszBuffer, nLength1, psz1, nLength1);
        CopyChars(pszBuffer + nLength1, nLength2, psz2, nLength2);
        strResult.ReleaseBufferSetLength(nNewLength);
    }

CopyChars()

template<typename BaseType, bool t_bMFCDLL = false>

static void __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CopyChars ( _Out_writes_to_(nDestLen, nChars) XCHAR *  pchDest, _In_ size_t  nDestLen, _In_reads_opt_(nChars) const XCHAR *  pchSrc, _In_ int  nChars  ) throw ( )

inlinestatic

Definition at line 423 of file atlsimpstr.h.

    {
        memcpy(pchDest, pchSrc, nChars * sizeof(XCHAR));
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::__declspec(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CloneData(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Concatenate(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

CopyCharsOverlapped()

template<typename BaseType, bool t_bMFCDLL = false>

static void __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CopyCharsOverlapped ( _Out_writes_to_(nDestLen, nDestLen) XCHAR *  pchDest, _In_ size_t  nDestLen, _In_reads_(nChars) const XCHAR *  pchSrc, _In_ int  nChars  ) throw ( )

inlinestatic

Definition at line 432 of file atlsimpstr.h.

    {
        memmove(pchDest, pchSrc, nChars * sizeof(XCHAR));
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

Empty()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Empty ( ) throw ( )

inline

Definition at line 247 of file atlsimpstr.h.

    {
        CStringData* pOldData = GetData();
        IAtlStringMgr* pStringMgr = pOldData->pStringMgr;
        if (pOldData->nDataLength == 0) return;

        if (pOldData->IsLocked())
        {
            SetLength(0);
        }
        else
        {
            pOldData->Release();
            CStringData* pNewData = pStringMgr->GetNilString();
            Attach(pNewData);
        }
    }

Referenced by CFontExt::GetDetailsOf(), CAvailableApplicationInfo::GetString(), CAppScrnshotPreview::PreviousDisplayCleanup(), CAvailableApplicationInfo::RetrieveLanguages(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

GetAllocLength()

template<typename BaseType, bool t_bMFCDLL = false>

int ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetAllocLength ( ) const throw ( )

inline

Definition at line 351 of file atlsimpstr.h.

    {
        return GetData()->nAllocLength;
    }

Referenced by CCharMapWindow::ChangeMapFont(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

GetBuffer()

template<typename BaseType, bool t_bMFCDLL = false>

PXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetBuffer ( )

inline

Definition at line 334 of file atlsimpstr.h.

    {
        CStringData* pData = GetData();
        if (pData->IsShared())
        {
            // We should fork here
            Fork(pData->nDataLength);
        }

        return m_pszData;
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), AvailableStrings::AvailableStrings(), CConfigParser::CacheINILocale(), CCharMapWindow::ChangeMapFont(), ChooseFolder(), CInstalledApplicationInfo::CInstalledApplicationInfo(), CAppsListView::CompareFunc(), CZipExtract::CZipExtract(), CAppScrnshotPreview::DisplayImage(), CMyDocsDropHandler::Drop(), CInstalledApps::Enum(), FillDefaultSettings(), ATL::CTimeSpan::Format(), ATL::CTime::Format(), ATL::CTime::FormatGmt(), CEditCompatModes::GetListText(), CConfigParser::GetString(), CLayerUIPropPage::InitFile(), MultiByteToWide(), CZipPassword::OnButton(), CCopyToMenu::QueryContextMenu(), CSendToMenu::QueryContextMenu(), CMoveToMenu::QueryContextMenu(), CShellLink::QueryContextMenu(), ReadFileHistory(), CAvailableApplicationInfo::RetrieveGeneralInfo(), CAvailableApplicationInfo::RetrieveSize(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), CFindFolder::StartSearch(), CCharMapWindow::StatusBarLoadString(), tmToStr(), and WideToMultiByte().

GetData()

template<typename BaseType, bool t_bMFCDLL = false>

CStringData* ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetData ( ) const throw ( )

inline

Definition at line 384 of file atlsimpstr.h.

    {
        return (reinterpret_cast<CStringData*>(m_pszData) - 1);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::__declspec(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Empty(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetAllocLength(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetBuffer(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetLength(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetManager(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator=(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::PrepareWrite(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::PrepareWrite2(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Reallocate(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetLength(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::~CSimpleStringT().

GetLength()

template<typename BaseType, bool t_bMFCDLL = false>

int ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetLength ( ) const throw ( )

inline

Definition at line 356 of file atlsimpstr.h.

    {
        return GetData()->nDataLength;
    }

Referenced by CACLCustomMRU::AddMRUString(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), CConfigParser::CacheINILocale(), CMyDocsDropHandler::Drop(), FillDefaultSettings(), CFontExt::GetDetailsOf(), CLayerUIPropPage::InitFile(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::IsEmpty(), CDownloaderProgress::OnPaint(), CACLCustomMRU::PersistMRU(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString(), and anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc().

GetManager()

template<typename BaseType, bool t_bMFCDLL = false>

IAtlStringMgr* ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetManager ( ) const throw ( )

inline

Definition at line 389 of file atlsimpstr.h.

    {
        IAtlStringMgr* pStringMgr = GetData()->pStringMgr;
        return (pStringMgr ? pStringMgr->Clone() : NULL);
    }

GetString()

template<typename BaseType, bool t_bMFCDLL = false>

PCXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::GetString ( ) const throw ( )

inline

Definition at line 361 of file atlsimpstr.h.

    {
        return m_pszData;
    }

Referenced by CAppsListView::AddAvailableApplication(), CAppsListView::AddInstalledApplication(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), ChooseFolder(), CMainWindow::Create(), CAvailableApps::DeleteCurrentAppsDB(), CAppScrnshotPreview::DisplayImage(), DisplayTrayProperties(), CDownloadManager::DownloadDlgProc(), CInstalledApps::Enum(), CAvailableApps::Enum(), CZipExtract::Extract(), ExtractFilesFromCab(), FillDefaultSettings(), FNFDINOTIFY(), FontFolderMenuCallback(), CConfigParser::GetINIFullPath(), CConfigParser::GetString(), LoadAndInitialize(), MessageBox_LoadString(), CZipExtract::CExtractSettingsPage::OnBrowse(), CApplicationView::OnCommand(), CConfirmReplace::OnInitDialog(), CZipPassword::OnInitDialog(), CDownloaderProgress::OnPaint(), CAppScrnshotPreview::PreviousDisplayCleanup(), CAvailableApplicationInfo::RetrieveGeneralInfo(), CAvailableApplicationInfo::RetrieveLanguages(), CDowloadingAppsListView::SetDownloadStatus(), CDownloaderProgress::SetProgress(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), START_TEST(), CDownloadManager::ThreadFunc(), wmain(), and wWinMain().

IsEmpty()

template<typename BaseType, bool t_bMFCDLL = false>

bool ATL::CSimpleStringT< BaseType, t_bMFCDLL >::IsEmpty ( ) const throw ( )

inline

Definition at line 379 of file atlsimpstr.h.

    {
        return (GetLength() == 0);
    }

Referenced by CAppsListView::AddInstalledApplication(), ChooseFolder(), ContentsMatch(), copy_dir_to_dir(), copy_file_to_file(), FileNameMatch(), GetInstalledVersion(), LoadAndInitialize(), CApplicationView::OnCommand(), CZipPassword::OnInitDialog(), CMainWindow::OnInitMenuPopup(), CAppScrnshotPreview::PreviousDisplayCleanup(), RecursiveFind(), CAvailableApplicationInfo::RefreshAppInfo(), CInstalledApplicationInfo::RetrieveIcon(), CAvailableApplicationInfo::RetrieveIcon(), CAvailableApplicationInfo::RetrieveLanguages(), CFontCache::SetFontDir(), RegistrySettings::Store(), CFontInfo::Valid(), and wmain().

operator PCXSTR()

template<typename BaseType, bool t_bMFCDLL = false>

ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator PCXSTR ( ) const throw ( )

inline

Definition at line 242 of file atlsimpstr.h.

    {
        return m_pszData;
    }

operator+=() [1/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT& ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator+= ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 224 of file atlsimpstr.h.

    {
        Append(strSrc);
        return *this;
    }

operator+=() [2/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT& ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator+= ( _In_z_ PCXSTR  pszSrc )

inline

Definition at line 230 of file atlsimpstr.h.

    {
        Append(pszSrc);
        return *this;
    }

operator+=() [3/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT& ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator+= ( XCHAR  ch )

inline

Definition at line 236 of file atlsimpstr.h.

    {
        Append(&ch, 1);
        return *this;
    }

operator=() [1/2]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT& ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator= ( _In_opt_z_ PCXSTR  pszSrc )

inline

Definition at line 196 of file atlsimpstr.h.

    {
        SetString(pszSrc);
        return *this;
    }

operator=() [2/2]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT& ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator= ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 202 of file atlsimpstr.h.

    {
        CStringData* pData = GetData();
        CStringData* pNewData = strSrc.GetData();

        if (pNewData != pData)
        {
            if (!pData->IsLocked() && (pNewData->pStringMgr == pData->pStringMgr))
            {
                pNewData = CloneData(pNewData);
                pData->Release();
                Attach(pNewData);
            }
            else
            {
                SetString(strSrc.GetString(), strSrc.GetLength());
            }
        }

        return *this;
    }

PrepareWrite()

template<typename BaseType, bool t_bMFCDLL = false>

PXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PrepareWrite ( _In_ int  nLength )

inlineprivate

Definition at line 510 of file atlsimpstr.h.

    {
        CStringData* pOldData = GetData();
        int nShared = 1 - pOldData->nRefs;
        int nTooShort = pOldData->nAllocLength - nLength;
        if ((nShared | nTooShort) < 0)
        {
            PrepareWrite2(nLength);
        }

        return m_pszData;
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::_Post_writable_size_().

PrepareWrite2()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::PrepareWrite2 ( _In_ int  nLength )

inlineprivate

Definition at line 522 of file atlsimpstr.h.

    {
        CStringData* pOldData = GetData();
        if (pOldData->nDataLength > nLength)
        {
            nLength = pOldData->nDataLength;
        }
        if (pOldData->IsShared())
        {
            Fork(nLength);
            //ATLASSERT(FALSE);
        }
        else if (pOldData->nAllocLength < nLength)
        {
            int nNewLength = pOldData->nAllocLength;
            if (nNewLength > 1024 * 1024 * 1024)
            {
                nNewLength += 1024 * 1024;
            }
            else
            {
                nNewLength = nNewLength + nNewLength / 2;
            }
            if (nNewLength < nLength)
            {
                nNewLength = nLength;
            }
            Reallocate(nNewLength);
        }
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::PrepareWrite().

Reallocate()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Reallocate ( _In_ int  nLength )

inlineprivate

Definition at line 553 of file atlsimpstr.h.

    {
        CStringData* pOldData = GetData();
        ATLASSERT(pOldData->nAllocLength < nLength);
        IAtlStringMgr* pStringMgr = pOldData->pStringMgr;
        if (pOldData->nAllocLength >= nLength || nLength <= 0)
        {
            return;
        }
        CStringData* pNewData = pStringMgr->Reallocate(pOldData, nLength, sizeof(XCHAR));
        if (pNewData == NULL)
        {
            ThrowMemoryException();
        }

        Attach(pNewData);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::PrepareWrite2().

ReleaseBuffer()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ReleaseBuffer ( _In_ int  nNewLength = -1 )

inline

Definition at line 372 of file atlsimpstr.h.

    {
        if (nNewLength < 0)
            nNewLength = StringLength(m_pszData);
        ReleaseBufferSetLength(nNewLength);
    }

Referenced by AvailableStrings::AvailableStrings(), CConfigParser::CacheINILocale(), ChooseFolder(), CInstalledApplicationInfo::CInstalledApplicationInfo(), CAppsListView::CompareFunc(), CZipExtract::CZipExtract(), CAppScrnshotPreview::DisplayImage(), CMyDocsDropHandler::Drop(), CInstalledApps::Enum(), FillDefaultSettings(), ATL::CTimeSpan::Format(), ATL::CTime::Format(), ATL::CTime::FormatGmt(), CEditCompatModes::GetListText(), CConfigParser::GetString(), MultiByteToWide(), CZipPassword::OnButton(), ReadFileHistory(), CAvailableApplicationInfo::RetrieveGeneralInfo(), CAvailableApplicationInfo::RetrieveSize(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), CFindFolder::StartSearch(), tmToStr(), and WideToMultiByte().

ReleaseBufferSetLength()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ReleaseBufferSetLength ( _In_ int  nNewLength )

inline

Definition at line 366 of file atlsimpstr.h.

    {
        ATLASSERT(nNewLength >= 0);
        SetLength(nNewLength);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), CLayerUIPropPage::InitFile(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::ReleaseBuffer(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

SetLength()

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetLength ( _In_ int  nLength )

inlineprivate

Definition at line 571 of file atlsimpstr.h.

    {
        ATLASSERT(nLength >= 0);
        ATLASSERT(nLength <= GetData()->nAllocLength);

        if (nLength < 0 || nLength > GetData()->nAllocLength)
        {
            AtlThrow(E_INVALIDARG);
        }

        GetData()->nDataLength = nLength;
        m_pszData[nLength] = 0;
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Empty(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::ReleaseBufferSetLength().

SetString() [1/2]

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString ( _In_opt_z_ PCXSTR  pszSrc )

inline

Definition at line 303 of file atlsimpstr.h.

    {
        SetString(pszSrc, StringLength(pszSrc));
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator=(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

SetString() [2/2]

template<typename BaseType, bool t_bMFCDLL = false>

void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString ( _In_reads_opt_(nLength) PCXSTR  pszSrc, _In_ int  nLength  )

inline

Definition at line 308 of file atlsimpstr.h.

    {
        if (nLength == 0)
        {
            Empty();
        }
        else
        {
            UINT nOldLength = GetLength();
            UINT_PTR nOffset = pszSrc - GetString();

            PXSTR pszBuffer = GetBuffer(nLength);
            if (nOffset <= nOldLength)
            {
                CopyCharsOverlapped(pszBuffer, GetAllocLength(),
                                    pszBuffer + nOffset, nLength);
            }
            else
            {
                CopyChars(pszBuffer, GetAllocLength(), pszSrc, nLength);
            }
            ReleaseBufferSetLength(nLength);
        }
    }

StringLength() [1/2]

template<typename BaseType, bool t_bMFCDLL = false>

static int __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::StringLength ( _In_opt_z_ const char *  psz ) throw ( )

inlinestatic

Definition at line 441 of file atlsimpstr.h.

    {
        if (psz == NULL) return 0;
        return (int)strlen(psz);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Append(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::ReleaseBuffer(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetString().

StringLength() [2/2]

template<typename BaseType, bool t_bMFCDLL = false>

static int __cdecl ATL::CSimpleStringT< BaseType, t_bMFCDLL >::StringLength ( _In_opt_z_ const wchar_t *  psz ) throw ( )

inlinestatic

Definition at line 447 of file atlsimpstr.h.

    {
        if (psz == NULL) return 0;
        return (int)wcslen(psz);
    }

ThrowInvalidArgException()

template<typename BaseType, bool t_bMFCDLL = false>

static void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ThrowInvalidArgException ( )

inlinestaticprotected

Definition at line 617 of file atlsimpstr.h.

    {
        AtlThrow(E_INVALIDARG);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT().

ThrowMemoryException()

template<typename BaseType, bool t_bMFCDLL = false>

static void ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ThrowMemoryException ( )

inlinestaticprotected

Definition at line 612 of file atlsimpstr.h.

    {
        AtlThrow(E_OUTOFMEMORY);
    }

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::__declspec(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CloneData(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Reallocate().

Friends And Related Function Documentation

operator+ [1/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT operator+ ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  str1, _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  str2  )

friend

Definition at line 396 of file atlsimpstr.h.

    {
        CSimpleStringT s(str1.GetManager());
        Concatenate(s, str1, str1.GetLength(), str2, str2.GetLength());
        return s;
    }

operator+ [2/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT operator+ ( _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  str1, _In_z_ PCXSTR  psz2  )

friend

Definition at line 405 of file atlsimpstr.h.

    {
        CSimpleStringT s(str1.GetManager());
        Concatenate(s, str1, str1.GetLength(), psz2, StringLength(psz2));
        return s;
    }

operator+ [3/3]

template<typename BaseType, bool t_bMFCDLL = false>

CSimpleStringT operator+ ( _In_z_ PCXSTR  psz1, _In_ const CSimpleStringT< BaseType, t_bMFCDLL > &  str2  )

friend

Definition at line 414 of file atlsimpstr.h.

    {
        CSimpleStringT s(str2.GetManager());
        Concatenate(s, psz1, StringLength(psz1), str2, str2.GetLength());
        return s;
    }

Member Data Documentation

m_pszData

template<typename BaseType, bool t_bMFCDLL = false>

PXSTR ATL::CSimpleStringT< BaseType, t_bMFCDLL >::m_pszData

private

Definition at line 142 of file atlsimpstr.h.

Referenced by ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::Attach(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetBuffer(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetData(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::GetString(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::operator PCXSTR(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::PrepareWrite(), ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::ReleaseBuffer(), and ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >::SetLength().

---

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

• sdk/lib/atl/atlsimpstr.h