ATL::CStringT< BaseType, StringTraits > Class Template Reference

#include <cstringt.h>

Inheritance diagram for ATL::CStringT< BaseType, StringTraits >:

Collaboration diagram for ATL::CStringT< BaseType, StringTraits >:

Public Types
typedef CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >	CThisSimpleString
typedef StringTraits	StrTraits
typedef CThisSimpleString::XCHAR	XCHAR
typedef CThisSimpleString::PXSTR	PXSTR
typedef CThisSimpleString::PCXSTR	PCXSTR
typedef CThisSimpleString::YCHAR	YCHAR
typedef CThisSimpleString::PYSTR	PYSTR
typedef CThisSimpleString::PCYSTR	PCYSTR
Public Types inherited from ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >
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
	CStringT () throw ()
	CStringT (_In_ IAtlStringMgr *pStringMgr) throw ()
	CStringT (_In_ const CStringT &strSrc)
	CStringT (_In_ const CThisSimpleString &strSrc)
template<class StringTraits_ >
	CStringT (_In_ const CStringT< YCHAR, StringTraits_ > &strSrc)
	CStringT (_In_opt_z_ const XCHAR *pszSrc)
	CStringT (_In_opt_z_ const XCHAR *pszSrc, _In_ IAtlStringMgr *pStringMgr)
	CStringT (_In_opt_z_ const YCHAR *pszSrc)
	CStringT (_In_opt_z_ const YCHAR *pszSrc, _In_ IAtlStringMgr *pStringMgr)
	CStringT (_In_reads_z_(nLength) const XCHAR *pch, _In_ int nLength)
	CStringT (_In_reads_z_(nLength) const YCHAR *pch, _In_ int nLength)
CStringT &	operator= (_In_ const CStringT &strSrc)
CStringT &	operator= (_In_opt_z_ PCXSTR pszSrc)
CStringT &	operator= (_In_opt_z_ PCYSTR pszSrc)
CStringT &	operator= (_In_ const CThisSimpleString &strSrc)
CStringT &	operator+= (_In_ const CThisSimpleString &str)
CStringT &	operator+= (_In_z_ PCXSTR pszSrc)
CStringT &	operator+= (_In_ XCHAR ch)
BOOL	LoadString (_In_ UINT nID)
_Check_return_ BOOL	LoadString (_In_ HINSTANCE hInstance, _In_ UINT nID)
BOOL	GetEnvironmentVariable (_In_z_ PCXSTR pszVar)
CStringT &	MakeLower ()
CStringT &	MakeUpper ()
int	Find (_In_ PCXSTR pszSub, _In_opt_ int iStart=0) const throw ()
int	Find (_In_ XCHAR ch, _In_opt_ int iStart=0) const throw ()
int	FindOneOf (_In_ PCXSTR pszCharSet) const throw ()
int	ReverseFind (_In_ XCHAR ch) const throw ()
int	Compare (_In_z_ PCXSTR psz) const
int	CompareNoCase (_In_z_ PCXSTR psz) const
CStringT	Mid (int iFirst, int nCount) const
CStringT	Mid (int iFirst) const
CStringT	Left (int nCount) const
CStringT	Right (int nCount) const
void __cdecl	Format (UINT nFormatID,...)
void __cdecl	Format (PCXSTR pszFormat,...)
void	FormatV (PCXSTR pszFormat, va_list args)
void __cdecl	FormatMessage (UINT nFormatID,...)
void __cdecl	FormatMessage (PCXSTR pszFormat,...)
void	FormatMessageV (PCXSTR pszFormat, va_list *pArgList)
int	Replace (PCXSTR pszOld, PCXSTR pszNew)
int	Replace (XCHAR chOld, XCHAR chNew)
CStringT	Tokenize (_In_z_ PCXSTR pszTokens, _Inout_ int &iStart) const
CStringT &	TrimLeft ()
CStringT &	TrimLeft (XCHAR chTarget)
CStringT &	TrimLeft (PCXSTR pszTargets)
CStringT &	TrimRight ()
CStringT &	TrimRight (XCHAR chTarget)
CStringT &	TrimRight (PCXSTR pszTargets)
CStringT &	Trim ()
CStringT &	Trim (XCHAR chTarget)
CStringT &	Trim (PCXSTR pszTargets)
BSTR	AllocSysString () const
Public Member Functions inherited from ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >
	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	Construct (_In_ CStringT *pString)
static PCXSTR	DefaultTrimChars ()
Static Public Member Functions inherited from ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >
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 ()

Protected Member Functions
template<typename T_CHAR >
void	LoadFromPtr_ (_In_opt_z_ const T_CHAR *pszSrc)

Friends
bool	operator== (const CStringT &str1, const CStringT &str2) throw ()
bool	operator== (const CStringT &str1, PCXSTR psz2) throw ()
bool	operator== (const CStringT &str1, PCYSTR psz2) throw ()
bool	operator== (const CStringT &str1, XCHAR ch2) throw ()
bool	operator== (PCXSTR psz1, const CStringT &str2) throw ()
bool	operator== (PCYSTR psz1, const CStringT &str2) throw ()
bool	operator== (XCHAR ch1, const CStringT &str2) throw ()

Additional Inherited Members
Static Protected Member Functions inherited from ATL::CSimpleStringT< BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck< BaseType, StringTraits >::c_bIsMFCDLLTraits >
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 ()

Detailed Description

template<typename BaseType, class StringTraits>
class ATL::CStringT< BaseType, StringTraits >

Definition at line 369 of file cstringt.h.

Member Typedef Documentation

CThisSimpleString

template<typename BaseType , class StringTraits >

typedef CSimpleStringT<BaseType, _CSTRING_IMPL_::_MFCDLLTraitsCheck<BaseType, StringTraits>::c_bIsMFCDLLTraits> ATL::CStringT< BaseType, StringTraits >::CThisSimpleString

Definition at line 373 of file cstringt.h.

PCXSTR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::PCXSTR ATL::CStringT< BaseType, StringTraits >::PCXSTR

Definition at line 377 of file cstringt.h.

PCYSTR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::PCYSTR ATL::CStringT< BaseType, StringTraits >::PCYSTR

Definition at line 380 of file cstringt.h.

PXSTR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::PXSTR ATL::CStringT< BaseType, StringTraits >::PXSTR

Definition at line 376 of file cstringt.h.

PYSTR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::PYSTR ATL::CStringT< BaseType, StringTraits >::PYSTR

Definition at line 379 of file cstringt.h.

StrTraits

template<typename BaseType , class StringTraits >

typedef StringTraits ATL::CStringT< BaseType, StringTraits >::StrTraits

Definition at line 374 of file cstringt.h.

XCHAR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::XCHAR ATL::CStringT< BaseType, StringTraits >::XCHAR

Definition at line 375 of file cstringt.h.

YCHAR

template<typename BaseType , class StringTraits >

typedef CThisSimpleString::YCHAR ATL::CStringT< BaseType, StringTraits >::YCHAR

Definition at line 378 of file cstringt.h.

Constructor & Destructor Documentation

CStringT() [1/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( ) throw ( )

inline

Definition at line 383 of file cstringt.h.

                       :
        CThisSimpleString(StringTraits::GetDefaultManager())
    {
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Left(), ATL::CStringT< BaseType, StringTraits >::Mid(), ATL::CStringT< BaseType, StringTraits >::Right(), and ATL::CStringT< BaseType, StringTraits >::Tokenize().

CStringT() [2/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_ IAtlStringMgr *  pStringMgr ) throw ( )

inlineexplicit

Definition at line 388 of file cstringt.h.

                                                               :
        CThisSimpleString(pStringMgr)
    {
    }

CStringT() [3/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_ const CStringT< BaseType, StringTraits > &  strSrc )

inline

Definition at line 398 of file cstringt.h.

                                          :
        CThisSimpleString(strSrc)
    {
    }

CStringT() [4/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_ const CThisSimpleString &  strSrc )

inline

Definition at line 403 of file cstringt.h.

                                                   :
        CThisSimpleString(strSrc)
    {
    }

CStringT() [5/11]

template<typename BaseType , class StringTraits >

template<class StringTraits_ >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_ const CStringT< YCHAR, StringTraits_ > &  strSrc )

inline

Definition at line 409 of file cstringt.h.

                                                                 :
        CThisSimpleString(StringTraits::GetDefaultManager())
    {
        *this = static_cast<const YCHAR*>(strSrc);
    }

CStringT() [6/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_opt_z_ const XCHAR *  pszSrc )

inline

Definition at line 429 of file cstringt.h.

                                             :
        CThisSimpleString(StringTraits::GetDefaultManager())
    {
        LoadFromPtr_(pszSrc);
    }

CStringT() [7/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_opt_z_ const XCHAR *  pszSrc, _In_ IAtlStringMgr *  pStringMgr  )

inline

Definition at line 435 of file cstringt.h.

                                             : CThisSimpleString(pStringMgr)
    {
        LoadFromPtr_(pszSrc);
    }

CStringT() [8/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_opt_z_ const YCHAR *  pszSrc )

inline

Definition at line 441 of file cstringt.h.

                                             :
        CThisSimpleString(StringTraits::GetDefaultManager())
    {
        LoadFromPtr_(pszSrc);
    }

CStringT() [9/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_opt_z_ const YCHAR *  pszSrc, _In_ IAtlStringMgr *  pStringMgr  )

inline

Definition at line 447 of file cstringt.h.

                                             : CThisSimpleString(pStringMgr)
    {
        LoadFromPtr_(pszSrc);
    }

CStringT() [10/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_reads_z_(nLength) const XCHAR *  pch, _In_ int  nLength  )

inline

Definition at line 453 of file cstringt.h.

                               : 
        CThisSimpleString(pch, nLength, StringTraits::GetDefaultManager())
    {
    }

CStringT() [11/11]

template<typename BaseType , class StringTraits >

ATL::CStringT< BaseType, StringTraits >::CStringT ( _In_reads_z_(nLength) const YCHAR *  pch, _In_ int  nLength  )

inline

Definition at line 459 of file cstringt.h.

                               : 
        CThisSimpleString(pch, nLength, StringTraits::GetDefaultManager())
    {
    }

Member Function Documentation

AllocSysString()

template<typename BaseType , class StringTraits >

BSTR ATL::CStringT< BaseType, StringTraits >::AllocSysString ( ) const

inline

Definition at line 951 of file cstringt.h.

    {
        return StringTraits::AllocSysString(CThisSimpleString::GetString(), CThisSimpleString::GetLength());
    }

Compare()

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::Compare ( _In_z_ PCXSTR  psz ) const

inline

Definition at line 653 of file cstringt.h.

    {
        return StringTraits::Compare(CThisSimpleString::GetString(), psz);
    }

Referenced by CAppsListView::CompareFunc(), and CAvailableApplicationInfo::HasUpdate().

CompareNoCase()

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::CompareNoCase ( _In_z_ PCXSTR  psz ) const

inline

Definition at line 658 of file cstringt.h.

    {
        return StringTraits::CompareNoCase(CThisSimpleString::GetString(), psz);
    }

Referenced by CFontCache::Filename().

Construct()

template<typename BaseType , class StringTraits >

static void __cdecl ATL::CStringT< BaseType, StringTraits >::Construct ( _In_ CStringT< BaseType, StringTraits > *  pString )

inlinestatic

Definition at line 393 of file cstringt.h.

    {
        new(pString) CStringT;
    }

DefaultTrimChars()

template<typename BaseType , class StringTraits >

static PCXSTR ATL::CStringT< BaseType, StringTraits >::DefaultTrimChars ( )

inlinestatic

Definition at line 871 of file cstringt.h.

    {
        static XCHAR str[] = { ' ', '\t', '\r', '\n', 0 };
        return str;
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Trim(), ATL::CStringT< BaseType, StringTraits >::TrimLeft(), and ATL::CStringT< BaseType, StringTraits >::TrimRight().

Find() [1/2]

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::Find ( _In_ PCXSTR  pszSub, _In_opt_ int  iStart = 0  ) const throw ( )

inline

Definition at line 611 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (iStart >= nLength || iStart < 0)
            return -1;

        PCXSTR pszString = CThisSimpleString::GetString();
        PCXSTR pszResult = StringTraits::FindString(pszString + iStart, pszSub);

        return pszResult ? ((int)(pszResult - pszString)) : -1;
    }

Referenced by FNFDINOTIFY(), and CACLCustomMRU::LoadMRUList().

Find() [2/2]

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::Find ( _In_ XCHAR  ch, _In_opt_ int  iStart = 0  ) const throw ( )

inline

Definition at line 624 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (iStart >= nLength || iStart < 0)
            return -1;

        PCXSTR pszString = CThisSimpleString::GetString();
        PCXSTR pszResult = StringTraits::FindChar(pszString + iStart, ch);

        return pszResult ? ((int)(pszResult - pszString)) : -1;
    }

FindOneOf()

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::FindOneOf ( _In_ PCXSTR  pszCharSet ) const throw ( )

inline

Definition at line 637 of file cstringt.h.

    {
        PCXSTR pszString = CThisSimpleString::GetString();
        PCXSTR pszResult = StringTraits::FindOneOf(pszString, pszCharSet);

        return pszResult ? ((int)(pszResult - pszString)) : -1;
    }

Format() [1/2]

template<typename BaseType , class StringTraits >

void __cdecl ATL::CStringT< BaseType, StringTraits >::Format ( UINT  nFormatID,   ...  )

inline

Definition at line 716 of file cstringt.h.

    {
        va_list args;
        va_start(args, nFormatID);
        CStringT formatString;
        if (formatString.LoadString(nFormatID))
            FormatV(formatString, args);
        va_end(args);
    }

Referenced by _ShowContextMenu(), _tWinMain(), CMainWindow::ConfirmSave(), CCopyToMenu::DoCopyToFolder(), DoLoadImageFile(), CMoveToMenu::DoMoveToFolder(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), DynamicLoadIcon(), CConfigParser::GetINIFullPath(), CAppRichEdit::InsertLanguageInfo(), CZipCreatorImpl::JustDoIt(), NewExtDlg_OnOK(), CAttributesDialog::OnInitDialog(), CSizeboxWindow::OnMouseMove(), CSelectionWindow::OnMouseMove(), CImgAreaWindow::OnMouseMove(), CAttributesDialog::OnRadioButton1(), CAttributesDialog::OnRadioButton2(), CAvailableApplicationInfo::RetrieveGeneralInfo(), CMainWindow::saveImage(), SetBitmapAndInfo(), CDownloaderProgress::SetProgress(), ShowFileLoadError(), test_IACLCustomMRU_ExtraChars(), CDownloadManager::ThreadFunc(), try_find_new_name(), CMainWindow::UpdateStatusBarText(), and wWinMain().

Format() [2/2]

template<typename BaseType , class StringTraits >

void __cdecl ATL::CStringT< BaseType, StringTraits >::Format ( PCXSTR  pszFormat,   ...  )

inline

Definition at line 726 of file cstringt.h.

    {
        va_list args;
        va_start(args, pszFormat);
        FormatV(pszFormat, args);
        va_end(args);
    }

FormatMessage() [1/2]

template<typename BaseType , class StringTraits >

void __cdecl ATL::CStringT< BaseType, StringTraits >::FormatMessage ( UINT  nFormatID,   ...  )

inline

Definition at line 743 of file cstringt.h.

    {
        va_list va;
        va_start(va, nFormatID);

        CStringT str;
        if (str.LoadString(nFormatID))
            FormatMessageV(str, &va);

        va_end(va);
    }

FormatMessage() [2/2]

template<typename BaseType , class StringTraits >

void __cdecl ATL::CStringT< BaseType, StringTraits >::FormatMessage ( PCXSTR  pszFormat,   ...  )

inline

Definition at line 755 of file cstringt.h.

    {
        va_list va;
        va_start(va, pszFormat);
        FormatMessageV(pszFormat, &va);
        va_end(va);
    }

FormatMessageV()

template<typename BaseType , class StringTraits >

void ATL::CStringT< BaseType, StringTraits >::FormatMessageV ( PCXSTR  pszFormat, va_list *  pArgList  )

inline

Definition at line 764 of file cstringt.h.

    {
        PXSTR psz = StringTraits::FormatMessageV(pszFormat, pArgList);
        if (!psz)
            CThisSimpleString::ThrowMemoryException();

        *this = psz;
        ::LocalFree(psz);
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::FormatMessage().

FormatV()

template<typename BaseType , class StringTraits >

void ATL::CStringT< BaseType, StringTraits >::FormatV ( PCXSTR  pszFormat, va_list  args  )

inline

Definition at line 734 of file cstringt.h.

    {
        int nLength = StringTraits::FormatV(NULL, pszFormat, args);

        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);
        StringTraits::FormatV(pszBuffer, pszFormat, args);
        CThisSimpleString::ReleaseBufferSetLength(nLength);
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Format().

GetEnvironmentVariable()

template<typename BaseType , class StringTraits >

BOOL ATL::CStringT< BaseType, StringTraits >::GetEnvironmentVariable ( _In_z_ PCXSTR  pszVar )

inline

Definition at line 573 of file cstringt.h.

    {
        int nLength = StringTraits::GetEnvironmentVariable(pszVar, NULL, 0);

        if (nLength > 0)
        {
            PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);
            StringTraits::GetEnvironmentVariable(pszVar, pszBuffer, nLength);
            CThisSimpleString::ReleaseBuffer();
            return TRUE;
        }

        CThisSimpleString::Empty();
        return FALSE;
    }

Referenced by CLayerUIPropPage::InitFile(), and CTrayWindow::RunFileDlgThread().

Left()

template<typename BaseType , class StringTraits >

CStringT ATL::CStringT< BaseType, StringTraits >::Left ( int  nCount ) const

inline

Definition at line 691 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (nCount < 0)
            nCount = 0;
        if (nCount > nLength)
            nCount = nLength;

        return CStringT(CThisSimpleString::GetString(), nCount);
    }

Referenced by CACLCustomMRU::AddMRUString(), and CLayerUIPropPage::InitFile().

LoadFromPtr_()

template<typename BaseType , class StringTraits >

template<typename T_CHAR >

void ATL::CStringT< BaseType, StringTraits >::LoadFromPtr_ ( _In_opt_z_ const T_CHAR *  pszSrc )

inlineprotected

Definition at line 418 of file cstringt.h.

    {
        if (pszSrc == NULL)
            return;
        if (IS_INTRESOURCE(pszSrc))
            LoadString(LOWORD(pszSrc));
        else
            *this = pszSrc;
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::CStringT().

LoadString() [1/2]

template<typename BaseType , class StringTraits >

BOOL ATL::CStringT< BaseType, StringTraits >::LoadString ( _In_ UINT  nID )

inline

Definition at line 554 of file cstringt.h.

    {
        return LoadString(_AtlBaseModule.GetResourceInstance(), nID);
    }

Referenced by _tWinMain(), CMainWindow::ConfirmSave(), ATL::CTimeSpan::Format(), ATL::CTime::Format(), ATL::CStringT< BaseType, StringTraits >::Format(), ATL::CTime::FormatGmt(), CFontExt::GetDetailsOf(), ATL::CStringT< BaseType, StringTraits >::LoadFromPtr_(), NewExtDlg_OnOK(), CLayerUIPropPage::OnInitDialog(), CStretchSkewDialog::OnOk(), ShowFileLoadError(), and wWinMain().

LoadString() [2/2]

template<typename BaseType , class StringTraits >

_Check_return_ BOOL ATL::CStringT< BaseType, StringTraits >::LoadString ( _In_ HINSTANCE  hInstance, _In_ UINT  nID  )

inline

Definition at line 559 of file cstringt.h.

    {
        const ATLSTRINGRESOURCEIMAGE* pImage = AtlGetStringResourceImage(hInstance, nID);
        if (pImage == NULL) return FALSE;

        int nLength = StringTraits::GetBaseTypeLength(pImage->achString, pImage->nLength);
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);
        StringTraits::ConvertToBaseType(pszBuffer, nLength, pImage->achString, pImage->nLength);
        CThisSimpleString::ReleaseBufferSetLength(nLength);

        return TRUE;
    }

MakeLower()

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::MakeLower ( )

inline

Definition at line 589 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);

        StringTraits::MakeLower(pszBuffer, nLength);
        CThisSimpleString::ReleaseBufferSetLength(nLength);

        return *this;
    }

Referenced by CLayerUIPropPage::InitFile().

MakeUpper()

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::MakeUpper ( )

inline

Definition at line 600 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);

        StringTraits::MakeUpper(pszBuffer, nLength);
        CThisSimpleString::ReleaseBufferSetLength(nLength);

        return *this;
    }

Referenced by DoGetNameInZip().

Mid() [1/2]

template<typename BaseType , class StringTraits >

CStringT ATL::CStringT< BaseType, StringTraits >::Mid ( int  iFirst, int  nCount  ) const

inline

Definition at line 663 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (iFirst < 0)
            iFirst = 0;
        if (nCount < 0)
            nCount = 0;
        if (iFirst > nLength)
            iFirst = nLength;
        if (iFirst + nCount > nLength)
            nCount = nLength - iFirst;

        return CStringT(CThisSimpleString::GetString() + iFirst, nCount);
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Tokenize().

Mid() [2/2]

template<typename BaseType , class StringTraits >

CStringT ATL::CStringT< BaseType, StringTraits >::Mid ( int  iFirst ) const

inline

Definition at line 679 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (iFirst < 0)
            iFirst = 0;
        if (iFirst > nLength)
            iFirst = nLength;

        return CStringT(CThisSimpleString::GetString() + iFirst, nLength - iFirst);
    }

operator+=() [1/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator+= ( _In_ const CThisSimpleString &  str )

inline

Definition at line 536 of file cstringt.h.

    {
        CThisSimpleString::operator+=(str);
        return *this;
    }

operator+=() [2/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator+= ( _In_z_ PCXSTR  pszSrc )

inline

Definition at line 542 of file cstringt.h.

    {
        CThisSimpleString::operator+=(pszSrc);
        return *this;
    }

operator+=() [3/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator+= ( _In_ XCHAR  ch )

inline

Definition at line 548 of file cstringt.h.

    {
        CThisSimpleString::operator+=(ch);
        return *this;
    }

operator=() [1/4]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator= ( _In_ const CStringT< BaseType, StringTraits > &  strSrc )

inline

Definition at line 465 of file cstringt.h.

    {
        CThisSimpleString::operator=(strSrc);
        return *this;
    }

operator=() [2/4]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator= ( _In_opt_z_ PCXSTR  pszSrc )

inline

Definition at line 471 of file cstringt.h.

    {
        CThisSimpleString::operator=(pszSrc);
        return *this;
    }

operator=() [3/4]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator= ( _In_opt_z_ PCYSTR  pszSrc )

inline

Definition at line 477 of file cstringt.h.

    {
        int length = pszSrc ? StringTraits::GetBaseTypeLength(pszSrc) : 0;
        if (length > 0)
        {
            PXSTR result = CThisSimpleString::GetBuffer(length);
            StringTraits::ConvertToBaseType(result, length, pszSrc);
            CThisSimpleString::ReleaseBufferSetLength(length);
        }
        else
        {
            CThisSimpleString::Empty();
        }
        return *this;
    }

operator=() [4/4]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::operator= ( _In_ const CThisSimpleString &  strSrc )

inline

Definition at line 493 of file cstringt.h.

    {
        CThisSimpleString::operator=(strSrc);
        return *this;
    }

Replace() [1/2]

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::Replace ( PCXSTR  pszOld, PCXSTR  pszNew  )

inline

Definition at line 774 of file cstringt.h.

    {
        PCXSTR pszString = CThisSimpleString::GetString();

        const int nLength = CThisSimpleString::GetLength();
        const int nOldLen = StringTraits::GetBaseTypeLength(pszOld);
        const int nNewLen = StringTraits::GetBaseTypeLength(pszNew);
        const int nDiff = nNewLen - nOldLen;
        int nResultLength = nLength;

        PCXSTR pszFound;
        while ((pszFound = StringTraits::FindString(pszString, pszOld)))
        {
            nResultLength += nDiff;
            pszString = pszFound + nOldLen;
        }

        if (pszString == CThisSimpleString::GetString())
            return 0;

        PXSTR pszResult = CThisSimpleString::GetBuffer(nResultLength);
        PXSTR pszNext;
        int nCount = 0, nRemaining = nLength;
        while (nRemaining && (pszNext = StringTraits::FindString(pszResult, pszOld)))
        {
            nRemaining -= (pszNext - pszResult);
            nRemaining -= nOldLen;
            if (nRemaining > 0)
                CThisSimpleString::CopyCharsOverlapped(pszNext + nNewLen, nRemaining + 1, pszNext + nOldLen, nRemaining + 1);
            CThisSimpleString::CopyCharsOverlapped(pszNext, nNewLen, pszNew, nNewLen);
            pszResult = pszNext + nNewLen;
            nCount++;
        }

        CThisSimpleString::ReleaseBufferSetLength(nResultLength);

        return nCount;
    }

Referenced by CACLCustomMRU::AddMRUString(), CCopyToMenu::DoRealCopy(), CMoveToMenu::DoRealMove(), CDownloadManager::DownloadDlgProc(), and CZipExtract::Extract().

Replace() [2/2]

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::Replace ( XCHAR  chOld, XCHAR  chNew  )

inline

Definition at line 813 of file cstringt.h.

    {
        PCXSTR pszString = CThisSimpleString::GetString();
        PXSTR pszFirst = StringTraits::FindChar(pszString, chOld);
        if (!pszFirst)
            return 0;

        int nLength = CThisSimpleString::GetLength();
        int nCount = 0;

        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);
        pszFirst = pszBuffer + (pszFirst - pszString);
        do {
            *pszFirst = chNew;
            ++nCount;
        } while ((pszFirst = StringTraits::FindChar(pszFirst + 1, chOld)));

        CThisSimpleString::ReleaseBufferSetLength(nLength);
        return nCount;
    }

ReverseFind()

template<typename BaseType , class StringTraits >

int ATL::CStringT< BaseType, StringTraits >::ReverseFind ( _In_ XCHAR  ch ) const throw ( )

inline

Definition at line 645 of file cstringt.h.

    {
        PCXSTR pszString = CThisSimpleString::GetString();
        PCXSTR pszResult = StringTraits::FindCharReverse(pszString, ch);

        return pszResult ? ((int)(pszResult - pszString)) : -1;
    }

Right()

template<typename BaseType , class StringTraits >

CStringT ATL::CStringT< BaseType, StringTraits >::Right ( int  nCount ) const

inline

Definition at line 703 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();

        if (nCount < 0)
            nCount = 0;
        if (nCount > nLength)
            nCount = nLength;

        return CStringT(CThisSimpleString::GetString() + nLength - nCount, nCount);
    }

Referenced by CConfigParser::CacheINILocale().

Tokenize()

template<typename BaseType , class StringTraits >

CStringT ATL::CStringT< BaseType, StringTraits >::Tokenize ( _In_z_ PCXSTR  pszTokens, _Inout_ int &  iStart  ) const

inline

Definition at line 835 of file cstringt.h.

    {
        ATLASSERT(iStart >= 0);

        if (iStart < 0)
            AtlThrow(E_INVALIDARG);

        if (!pszTokens || !pszTokens[0])
        {
            if (iStart < CThisSimpleString::GetLength())
            {
                return Mid(iStart);
            }
            iStart = -1;
            return CStringT();
        }

        if (iStart < CThisSimpleString::GetLength())
        {
            int iRangeOffset = StringTraits::StringSpanIncluding(CThisSimpleString::GetString() + iStart, pszTokens);

            if (iRangeOffset + iStart < CThisSimpleString::GetLength())
            {
                int iNewStart = iStart + iRangeOffset;
                int nCount = StringTraits::StringSpanExcluding(CThisSimpleString::GetString() + iNewStart, pszTokens);

                iStart = iNewStart + nCount + 1;

                return Mid(iNewStart, nCount);
            }
        }

        iStart = -1;
        return CStringT();
    }

Referenced by FNFDINOTIFY().

Trim() [1/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::Trim ( )

inline

Definition at line 934 of file cstringt.h.

    {
        return Trim(DefaultTrimChars());
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Trim().

Trim() [2/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::Trim ( XCHAR  chTarget )

inline

Definition at line 939 of file cstringt.h.

    {
        XCHAR str[2] = { chTarget, 0 };
        return Trim(str);
    }

Trim() [3/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::Trim ( PCXSTR  pszTargets )

inline

Definition at line 945 of file cstringt.h.

    {
        return TrimRight(pszTargets).TrimLeft(pszTargets);
    }

TrimLeft() [1/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimLeft ( )

inline

Definition at line 878 of file cstringt.h.

    {
        return TrimLeft(DefaultTrimChars());
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Trim(), and ATL::CStringT< BaseType, StringTraits >::TrimLeft().

TrimLeft() [2/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimLeft ( XCHAR  chTarget )

inline

Definition at line 883 of file cstringt.h.

    {
        XCHAR str[2] = { chTarget, 0 };
        return TrimLeft(str);
    }

TrimLeft() [3/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimLeft ( PCXSTR  pszTargets )

inline

Definition at line 889 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);
        int nCount = 0;

        while (nCount < nLength && StringTraits::FindChar(pszTargets, pszBuffer[nCount]))
            nCount++;

        if (nCount > 0)
        {
            CThisSimpleString::CopyCharsOverlapped(pszBuffer, nLength - nCount, pszBuffer + nCount, nLength - nCount);
            nLength -= nCount;
        }
        CThisSimpleString::ReleaseBufferSetLength(nLength);

        return *this;
    }

TrimRight() [1/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimRight ( )

inline

Definition at line 909 of file cstringt.h.

    {
        return TrimRight(DefaultTrimChars());
    }

Referenced by ATL::CStringT< BaseType, StringTraits >::Trim(), and ATL::CStringT< BaseType, StringTraits >::TrimRight().

TrimRight() [2/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimRight ( XCHAR  chTarget )

inline

Definition at line 914 of file cstringt.h.

    {
        XCHAR str[2] = { chTarget, 0 };
        return TrimRight(str);
    }

TrimRight() [3/3]

template<typename BaseType , class StringTraits >

CStringT& ATL::CStringT< BaseType, StringTraits >::TrimRight ( PCXSTR  pszTargets )

inline

Definition at line 920 of file cstringt.h.

    {
        int nLength = CThisSimpleString::GetLength();
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength);

        while (nLength > 0 && StringTraits::FindChar(pszTargets, pszBuffer[nLength-1]))
            nLength--;

        CThisSimpleString::ReleaseBufferSetLength(nLength);

        return *this;
    }

Friends And Related Function Documentation

operator== [1/7]

template<typename BaseType , class StringTraits >

bool operator== ( const CStringT< BaseType, StringTraits > &  str1, const CStringT< BaseType, StringTraits > &  str2  ) throw ( )

friend

Definition at line 499 of file cstringt.h.

    {
        return str1.Compare(str2) == 0;
    }

operator== [2/7]

template<typename BaseType , class StringTraits >

bool operator== ( const CStringT< BaseType, StringTraits > &  str1, PCXSTR  psz2  ) throw ( )

friend

Definition at line 504 of file cstringt.h.

    {
        return str1.Compare(psz2) == 0;
    }

operator== [3/7]

template<typename BaseType , class StringTraits >

bool operator== ( const CStringT< BaseType, StringTraits > &  str1, PCYSTR  psz2  ) throw ( )

friend

Definition at line 509 of file cstringt.h.

    {
        CStringT tmp(psz2, str1.GetManager());
        return tmp.Compare(str1) == 0;
    }

operator== [4/7]

template<typename BaseType , class StringTraits >

bool operator== ( const CStringT< BaseType, StringTraits > &  str1, XCHAR  ch2  ) throw ( )

friend

Definition at line 515 of file cstringt.h.

    {
        return str1.GetLength() == 1 && str1[0] == ch2;
    }

operator== [5/7]

template<typename BaseType , class StringTraits >

bool operator== ( PCXSTR  psz1, const CStringT< BaseType, StringTraits > &  str2  ) throw ( )

friend

Definition at line 520 of file cstringt.h.

    {
        return str2.Compare(psz1) == 0;
    }

operator== [6/7]

template<typename BaseType , class StringTraits >

bool operator== ( PCYSTR  psz1, const CStringT< BaseType, StringTraits > &  str2  ) throw ( )

friend

Definition at line 525 of file cstringt.h.

    {
        CStringT tmp(psz1, str2.GetManager());
        return tmp.Compare(str2) == 0;
    }

operator== [7/7]

template<typename BaseType , class StringTraits >

bool operator== ( XCHAR  ch1, const CStringT< BaseType, StringTraits > &  str2  ) throw ( )

friend

Definition at line 531 of file cstringt.h.

    {
        return str2.GetLength() == 1 && str2[0] == ch1;
    }

---

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

• sdk/lib/atl/cstringt.h