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

#include <atlsimpstr.h>

Collaboration diagram for ATL::CSimpleStringT< BaseType, t_bMFCDLL >:

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 () noexcept
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 noexcept
void	Empty () noexcept
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 noexcept
int	GetLength () const noexcept
PXSTR	GetString () noexcept
PCXSTR	GetString () const noexcept
void	Preallocate (_In_ int nLength)
void	ReleaseBufferSetLength (_In_ int nNewLength)
void	ReleaseBuffer (_In_ int nNewLength=-1)
bool	IsEmpty () const noexcept
CStringData *	GetData () const noexcept
IAtlStringMgr *	GetManager () const noexcept

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) noexcept
static void __cdecl	CopyCharsOverlapped (_Out_writes_to_(nDestLen, nDestLen) XCHAR *pchDest, _In_ size_t nDestLen, _In_reads_(nChars) const XCHAR *pchSrc, _In_ int nChars) noexcept
static int __cdecl	StringLength (_In_opt_z_ const char *psz) noexcept
static int __cdecl	StringLength (_In_opt_z_ const wchar_t *psz) noexcept

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) noexcept
	__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 137 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 142 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 145 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 141 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 144 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 140 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 143 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 151 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 157 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 164 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 178 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 ( )

inlinenoexcept

Definition at line 196 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 508 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 352 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_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 304 of file atlsimpstr.h.

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

Append() [2/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 271 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, t_bMFCDLL >::Append(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator+=(), and CZipExtract::ShowExtractError().

Append() [3/3]

template<typename BaseType , bool t_bMFCDLL = false>

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

inline

Definition at line 299 of file atlsimpstr.h.

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

Attach()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlineprivatenoexcept

Definition at line 503 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::__declspec(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Empty(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator=(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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 600 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, t_bMFCDLL >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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 488 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  )

inlinestaticnoexcept

Definition at line 438 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::__declspec(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CloneData(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Concatenate(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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  )

inlinestaticnoexcept

Definition at line 447 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString().

Empty()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 253 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 DoTestCaseB(), CInstalledApplicationInfo::GetApplicationRegString(), GetStorageDirectory(), CConfigParser::GetString(), CAutoComplete::LoadQuickComplete(), CDownloaderProgress::OnSetText(), ParseCmdAndExecute(), CAppScrnshotPreview::PreviousDisplayCleanup(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString(), Test_Exporter(), and Test_Importer().

GetAllocLength()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 357 of file atlsimpstr.h.

    {
        return GetData()->nAllocLength;
    }

Referenced by CCharMapWindow::ChangeMapFont(), ExtractFilesFromZip(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString().

GetBuffer()

template<typename BaseType , bool t_bMFCDLL = false>

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

inline

Definition at line 340 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, t_bMFCDLL >::Append(), CConfigParser::CacheINI(), CAvailableApplicationInfo::CAvailableApplicationInfo(), CCharMapWindow::ChangeMapFont(), CAppsListView::CompareFunc(), CZipExtract::CZipExtract(), CAppScrnshotPreview::DisplayImage(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), CAppDB::EnumerateFiles(), RunOnceExEntry::Exec(), ExtractAndInstallThread(), ExtractFilesFromZip(), ATL::CTimeSpan::Format(), ATL::CTime::Format(), ATL::CTime::FormatGmt(), CInstalledApplicationInfo::GetApplicationRegString(), GetDefaultDownloadDirectory(), GetStorageDirectory(), CLayerUIPropPage::InitFile(), MultiByteToWide(), CZipEnumerator::next(), CZipPassword::OnButton(), CZipExtract::CExtractSettingsPage::OnWizardNext(), CDownloadManager::PerformDownloadAndInstall(), CSendToMenu::QueryContextMenu(), CCopyAsPathMenu::QueryContextMenu(), CShellLink::QueryContextMenu(), CCopyMoveToMenu::QueryContextMenuImpl(), CAsyncLoadIcon::Queue(), ReadString(), CInstalledApplicationInfo::RetrieveInstallDate(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), SHGetIniStringW(), StartProcess(), CFindFolder::StartSearch(), CCharMapWindow::StatusBarLoadString(), tmToStr(), and WideToMultiByte().

GetData()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 399 of file atlsimpstr.h.

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

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

GetLength()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 362 of file atlsimpstr.h.

    {
        return GetData()->nDataLength;
    }

Referenced by CACLCustomMRU::AddMRUString(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append(), CConfigParser::CacheINI(), CAutoComplete::DoAutoAppend(), DoesMatch(), CMyDocsDropHandler::Drop(), ExtractAndInstallThread(), CFontExt::GetDetailsOf(), CACListISF::GetPaths(), RecycleBin5::Init(), CLayerUIPropPage::InitFile(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::IsEmpty(), CAutoComplete::OnEditKeyDown(), CAppsListView::OnEraseBackground(), CACListView::OnLButtonDown(), CDownloaderProgress::OnPaint(), CACLCustomMRU::PersistMRU(), CAsyncLoadIcon::Queue(), CConfigParser::ReadSection(), CInstalledApplicationInfo::RetrieveInstallDate(), CInstalledApplicationInfo::RetrieveUninstallStrings(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), CZipExtract::ShowExtractError(), and ValidateStringSettings().

GetManager()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 404 of file atlsimpstr.h.

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

GetString() [1/2]

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 371 of file atlsimpstr.h.

    {
        return m_pszData;
    }

GetString() [2/2]

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 367 of file atlsimpstr.h.

    {
        return m_pszData;
    }

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append(), CMainWindow::Create(), CMainToolbar::Create(), CreateMainShortcut(), CAppScrnshotPreview::DisplayImage(), DisplayTrayProperties(), CFontExt::Drop(), CCleanupHandlerList::ExecuteCleanup(), CZipExtract::Extract(), ExtractAndInstallThread(), ExtractFilesFromCab(), CFontInfo::File(), FNFDINOTIFY(), FontFolderMenuCallback(), LoadAndInitialize(), MessageBox_LoadString(), CZipExtract::CExtractSettingsPage::OnBrowse(), CApplicationView::OnCommand(), CAppsListView::OnEraseBackground(), CConfirmReplace::OnInitDialog(), CZipPassword::OnInitDialog(), CSelectDriveDlg::OnInitDialog(), CDownloaderProgress::OnPaint(), CAppScrnshotPreview::PreviousDisplayCleanup(), CConfigParser::ReadSection(), CInstalledApplicationInfo::RetrieveInstallDate(), CAvailableApplicationInfo::RetrieveScreenshot(), CInstalledApplicationInfo::RetrieveUninstallStrings(), CCleanupHandlerList::ScanDrive(), CDowloadingAppsListView::SetDownloadStatus(), CDownloaderProgress::SetProgress(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString(), CZipExtract::ShowExtractError(), ValidateStringSettings(), wmain(), and wWinMain().

IsEmpty()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 394 of file atlsimpstr.h.

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

Referenced by CMainWindow::AddApplicationsToView(), CConfigParser::CacheINI(), CInstalledApplicationInfo::CanModify(), CompareVersion(), ContentsMatch(), copy_dir_to_dir(), copy_file_to_file(), CAutoComplete::DoAutoAppend(), DoGetFileTitle(), ExtractAndInstallThread(), ExtractArchiveForExecution(), FileNameMatch(), GetInstalledVersion(), CAutoComplete::GetQuickEdit(), HandleInfoCommand(), RunOnceExInstance::HandleSubKey(), CAvailableApplicationInfo::LicenseString(), LoadAndInitialize(), CAppRichEdit::LoadAndInsertText(), CAutoComplete::LoadQuickComplete(), move_file_to_file(), CAutoComplete::OnAutoCompStart(), CApplicationView::OnCommand(), CAppsListView::OnEraseBackground(), CZipPassword::OnInitDialog(), CDownloaderProgress::OnSetText(), CDownloadManager::PerformDownloadAndInstall(), CAppScrnshotPreview::PreviousDisplayCleanup(), CMainWindow::ProcessFileMenu(), ProgressDlg::ProcessWindowMessage(), RecursiveFind(), CAutoComplete::ReLoadInnerList(), CAvailableApplicationInfo::RetrieveLanguages(), CFontCache::SetFontDir(), SHGetIniStringW(), CInstalledApplicationInfo::ShowAppInfo(), CInstalledApplicationInfo::UninstallApplication(), UninstallThread(), CMainWindow::UpdateApplicationsList(), CFontInfo::Valid(), CAvailableApplicationInfo::Valid(), CInstalledApplicationInfo::Valid(), and wmain().

operator PCXSTR()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinenoexcept

Definition at line 248 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 230 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 236 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 242 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_ const CSimpleStringT< BaseType, t_bMFCDLL > &  strSrc )

inline

Definition at line 208 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;
    }

operator=() [2/2]

template<typename BaseType , bool t_bMFCDLL = false>

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

inline

Definition at line 202 of file atlsimpstr.h.

    {
        SetString(pszSrc);
        return *this;
    }

Preallocate()

template<typename BaseType , bool t_bMFCDLL = false>

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

inline

Definition at line 376 of file atlsimpstr.h.

    {
        PrepareWrite(nLength);
    }

Referenced by CCharMapWindow::ChangeMapFont().

PrepareWrite()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlineprivate

Definition at line 525 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, t_bMFCDLL >::_Post_writable_size_(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Preallocate().

PrepareWrite2()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlineprivate

Definition at line 537 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, t_bMFCDLL >::PrepareWrite().

Reallocate()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlineprivate

Definition at line 568 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, t_bMFCDLL >::PrepareWrite2().

ReleaseBuffer()

template<typename BaseType , bool t_bMFCDLL = false>

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

inline

Definition at line 387 of file atlsimpstr.h.

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

Referenced by CConfigParser::CacheINI(), CAvailableApplicationInfo::CAvailableApplicationInfo(), CAppsListView::CompareFunc(), CZipExtract::CZipExtract(), CAppScrnshotPreview::DisplayImage(), CMyDocsDropHandler::Drop(), CAppDB::EnumerateFiles(), ExtractAndInstallThread(), ExtractFilesFromZip(), ATL::CTimeSpan::Format(), ATL::CTime::Format(), ATL::CTime::FormatGmt(), CInstalledApplicationInfo::GetApplicationRegString(), GetDefaultDownloadDirectory(), GetStorageDirectory(), MultiByteToWide(), CZipPassword::OnButton(), CZipExtract::CExtractSettingsPage::OnWizardNext(), CDownloadManager::PerformDownloadAndInstall(), CAsyncLoadIcon::Queue(), ReadString(), CInstalledApplicationInfo::RetrieveInstallDate(), anonymous_namespace{settingsdlg.cpp}::SettingsDlgProc(), SHGetIniStringW(), StartProcess(), 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 381 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append(), CLayerUIPropPage::InitFile(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ReleaseBuffer(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString().

SetLength()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlineprivate

Definition at line 586 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, t_bMFCDLL >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Empty(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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 309 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::operator=(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::SetString(), and CZipExtract::ShowExtractError().

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 314 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 )

inlinestaticnoexcept

Definition at line 456 of file atlsimpstr.h.

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

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::Append(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::ReleaseBuffer(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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 )

inlinestaticnoexcept

Definition at line 462 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 632 of file atlsimpstr.h.

    {
        AtlThrow(E_INVALIDARG);
    }

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT().

ThrowMemoryException()

template<typename BaseType , bool t_bMFCDLL = false>

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

inlinestaticprotected

Definition at line 627 of file atlsimpstr.h.

    {
        AtlThrow(E_OUTOFMEMORY);
    }

Referenced by ATL::CSimpleStringT< BaseType, t_bMFCDLL >::__declspec(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CloneData(), ATL::CSimpleStringT< BaseType, t_bMFCDLL >::CSimpleStringT(), and ATL::CSimpleStringT< BaseType, t_bMFCDLL >::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 411 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 420 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 429 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 148 of file atlsimpstr.h.

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

---

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

• sdk/lib/atl/atlsimpstr.h