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 () noexcept
	CStringT (_In_ IAtlStringMgr *pStringMgr) noexcept
	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 noexcept
int	Find (_In_ XCHAR ch, _In_opt_ int iStart=0) const noexcept
int	FindOneOf (_In_ PCXSTR pszCharSet) const noexcept
int	ReverseFind (_In_ XCHAR ch) const noexcept
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	AppendFormat (UINT nFormatID,...)
void __cdecl	AppendFormat (PCXSTR pszFormat,...)
void __cdecl	Format (UINT nFormatID,...)
void __cdecl	Format (PCXSTR pszFormat,...)
void	AppendFormatV (PCXSTR pszFormat, va_list args)
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 () 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	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) 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

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) noexcept
bool	operator== (const CStringT &str1, PCXSTR psz2) noexcept
bool	operator== (const CStringT &str1, PCYSTR psz2) noexcept
bool	operator== (const CStringT &str1, XCHAR ch2) noexcept
bool	operator== (PCXSTR psz1, const CStringT &str2) noexcept
bool	operator== (PCYSTR psz1, const CStringT &str2) noexcept
bool	operator== (XCHAR ch1, const CStringT &str2) noexcept
bool	operator!= (const CStringT &str1, const CStringT &str2) noexcept
bool	operator!= (const CStringT &str1, PCXSTR psz2) noexcept
bool	operator!= (const CStringT &str1, PCYSTR psz2) noexcept
bool	operator!= (const CStringT &str1, XCHAR ch2) noexcept
bool	operator!= (PCXSTR psz1, const CStringT &str2) noexcept
bool	operator!= (PCYSTR psz1, const CStringT &str2) noexcept
bool	operator!= (XCHAR ch1, const CStringT &str2) noexcept

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 417 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 421 of file cstringt.h.

PCXSTR

template<typename BaseType , class StringTraits >

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

Definition at line 425 of file cstringt.h.

PCYSTR

template<typename BaseType , class StringTraits >

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

Definition at line 428 of file cstringt.h.

PXSTR

template<typename BaseType , class StringTraits >

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

Definition at line 424 of file cstringt.h.

PYSTR

template<typename BaseType , class StringTraits >

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

Definition at line 427 of file cstringt.h.

StrTraits

template<typename BaseType , class StringTraits >

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

Definition at line 422 of file cstringt.h.

XCHAR

template<typename BaseType , class StringTraits >

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

Definition at line 423 of file cstringt.h.

YCHAR

template<typename BaseType , class StringTraits >

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

Definition at line 426 of file cstringt.h.

Constructor & Destructor Documentation

CStringT() [1/11]

template<typename BaseType , class StringTraits >

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

inlinenoexcept

Definition at line 431 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 )

inlineexplicitnoexcept

Definition at line 436 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 446 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 451 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 457 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 477 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 483 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 489 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 495 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 501 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 507 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 1063 of file cstringt.h.

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

AppendFormat() [1/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 810 of file cstringt.h.

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

AppendFormat() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 800 of file cstringt.h.

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

Referenced by to_str().

AppendFormatV()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 836 of file cstringt.h.

    {
        int nLength = StringTraits::FormatV(NULL, pszFormat, args);
        int nCurrent = CThisSimpleString::GetLength();
 
        PXSTR pszBuffer = CThisSimpleString::GetBuffer(nLength + nCurrent);
        StringTraits::FormatV(pszBuffer + nCurrent, pszFormat, args);
        CThisSimpleString::ReleaseBufferSetLength(nLength + nCurrent);
    }

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

Compare()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 738 of file cstringt.h.

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

Referenced by CAppsListView::CompareFunc(), ExtractAndInstallThread(), and CCleanupHandlerList::LoadHandlers().

CompareNoCase()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 743 of file cstringt.h.

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

Referenced by ExtractAndInstallThread(), ATL::CImage::FindCodecForExtension(), CImageDx::FindCodecForExtension(), CPropMapEqual::IsEqualKey(), CAvailableApplicationInfo::LicenseString(), CAutoComplete::OnAutoCompStart(), CFontsDialog::OnFontName(), PathIsEqualOrSubFolder(), and CApplicationView::RefreshAvailableItem().

Construct()

template<typename BaseType , class StringTraits >

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

inlinestatic

Definition at line 441 of file cstringt.h.

    {
        new(pString) CStringT;
    }

DefaultTrimChars()

template<typename BaseType , class StringTraits >

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

inlinestatic

Definition at line 983 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

inlinenoexcept

Definition at line 696 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 AddUninstallOperationsFromDB(), ExtractAndInstallThread(), ATL::CImage::FindCodecForExtension(), CImageDx::FindCodecForExtension(), FNFDINOTIFY(), CACLCustomMRU::LoadMRUList(), and CConfigParser::ReadSection().

Find() [2/2]

template<typename BaseType , class StringTraits >

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

inlinenoexcept

Definition at line 709 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

inlinenoexcept

Definition at line 722 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 ( PCXSTR  pszFormat,   ...  )

inline

Definition at line 828 of file cstringt.h.

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

Format() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 818 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(), CheckForError(), CMainWindow::ConfirmSave(), CCopyMoveToMenu::DoAction(), CMainWindow::DoCreate(), ToolsModel::DrawWithMouseTool(), CMyDocsDropHandler::Drop(), CDeskLinkDropHandler::Drop(), DynamicLoadIcon(), EditTypeDlg_OnCommand(), CCleanupHandlerList::ExecuteCleanup(), ExtractAndInstallThread(), CConfigParser::GetSectionString(), CCleanupHandler::Initialize(), CAvailableApplicationInfo::InsertLanguageInfo(), CZipCreatorImpl::JustDoIt(), CCleanupHandlerList::LoadHandlers(), NewExtDlg_OnOK(), CNewMenu::NewItemByNonCommand(), CAttributesDialog::OnInitDialog(), CSelectDriveDlg::OnInitDialog(), CCanvasWindow::OnMouseMove(), CAttributesDialog::OnRadioButton1(), CAttributesDialog::OnRadioButton2(), CToolSettingsWindow::OnVScroll(), CDownloadManager::PerformDownloadAndInstall(), CAvailableApplicationInfo::RetrieveScreenshot(), CInstalledApplicationInfo::RetrieveUninstallStrings(), CCleanupHandlerList::ScanDrive(), SetFileInfo(), CDownloaderProgress::SetProgress(), CZipExtract::ShowExtractError(), test_IACLCustomMRU_ExtraChars(), try_find_new_name(), UninstallThread(), CCleanMgrProperties::UpdateSpaceUsed(), CMainWindow::UpdateStatusBarText(), validate_operation(), and wWinMain().

FormatMessage() [1/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 867 of file cstringt.h.

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

FormatMessage() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 855 of file cstringt.h.

    {
        va_list va;
        va_start(va, nFormatID);
 
        CStringT str;
        if (str.LoadString(nFormatID))
            FormatMessageV(str, &va);
 
        va_end(va);
    }

Referenced by CZipExtract::ShowExtractError().

FormatMessageV()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 876 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 846 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(), and ShowError().

GetEnvironmentVariable()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 658 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 776 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(), AddUninstallOperationsFromDB(), CAutoComplete::DoAutoAppend(), ExtractAndInstallThread(), CAutoComplete::GetStemText(), RecycleBin5::Init(), CLayerUIPropPage::InitFile(), CAutoComplete::LoadQuickComplete(), CConfigParser::ReadSection(), and CInstalledApplicationInfo::RetrieveInstallDate().

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 466 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 >

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

inline

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

LoadString() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 639 of file cstringt.h.

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

Referenced by ATL::CStringT< BaseType, StringTraits >::AppendFormat(), CMainWindow::ConfirmSave(), ATL::CTime::Format(), ATL::CStringT< BaseType, StringTraits >::Format(), ATL::CTimeSpan::Format(), ATL::CTime::FormatGmt(), CFontExt::GetDetailsOf(), CMainWindow::GetOpenFileName(), NewExtDlg_OnOK(), CMainWindow::OnCommand(), CLayerUIPropPage::OnInitDialog(), CStretchSkewDialog::OnOk(), OpenMailer(), CCopyMoveToMenu::QueryContextMenuImpl(), ShowError(), CZipExtract::ShowExtractError(), and wWinMain().

MakeLower()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 674 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(), and NewExtDlg_OnOK().

MakeUpper()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 685 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 ) const

inline

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

Mid() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 748 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 AddUninstallOperationsFromDB(), ExtractAndInstallThread(), ExtractFilesFromZip(), ATL::CImage::FindCodecForExtension(), CImageDx::FindCodecForExtension(), InstallFiles(), CAutoComplete::LoadQuickComplete(), CConfigParser::ReadSection(), CInstalledApplicationInfo::RetrieveInstallDate(), and ATL::CStringT< BaseType, StringTraits >::Tokenize().

operator+=() [1/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 621 of file cstringt.h.

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

operator+=() [2/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 633 of file cstringt.h.

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

operator+=() [3/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 627 of file cstringt.h.

    {
        CThisSimpleString::operator+=(pszSrc);
        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 513 of file cstringt.h.

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

operator=() [2/4]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 541 of file cstringt.h.

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

operator=() [3/4]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 519 of file cstringt.h.

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

operator=() [4/4]

template<typename BaseType , class StringTraits >

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

inline

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

Replace() [1/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 886 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(), CreateMainShortcut(), CCopyMoveToMenu::DoRealFileOp(), ExtractFilesFromZip(), CMainWindow::GetOpenFileName(), and CMainWindow::GetSaveFileName().

Replace() [2/2]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 925 of file cstringt.h.

    {
        PXSTR 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

inlinenoexcept

Definition at line 730 of file cstringt.h.

    {
        PCXSTR pszString = CThisSimpleString::GetString();
        PCXSTR pszResult = StringTraits::FindCharReverse(pszString, ch);
 
        return pszResult ? ((int)(pszResult - pszString)) : -1;
    }

Referenced by ATL::CImage::FindCodecForExtension(), CImageDx::FindCodecForExtension(), CAutoComplete::GetStemText(), and CAutoComplete::LoadQuickComplete().

Right()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 788 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::CacheINI().

Tokenize()

template<typename BaseType , class StringTraits >

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

inline

Definition at line 947 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 CompareVersion(), FNFDINOTIFY(), and CAvailableApplicationInfo::RetrieveLanguages().

Trim() [1/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 1046 of file cstringt.h.

    {
        return Trim(DefaultTrimChars());
    }

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

Trim() [2/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 1057 of file cstringt.h.

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

Trim() [3/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 1051 of file cstringt.h.

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

TrimLeft() [1/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 990 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 ( PCXSTR  pszTargets )

inline

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

TrimLeft() [3/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 995 of file cstringt.h.

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

TrimRight() [1/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 1021 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 ( PCXSTR  pszTargets )

inline

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

TrimRight() [3/3]

template<typename BaseType , class StringTraits >

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

inline

Definition at line 1026 of file cstringt.h.

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

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  )

friend

Definition at line 584 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  )

friend

Definition at line 589 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  )

friend

Definition at line 594 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  )

friend

Definition at line 600 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  )

friend

Definition at line 605 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  )

friend

Definition at line 610 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  )

friend

Definition at line 616 of file cstringt.h.

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

operator== [1/7]

template<typename BaseType , class StringTraits >

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

friend

Definition at line 547 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  )

friend

Definition at line 552 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  )

friend

Definition at line 557 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  )

friend

Definition at line 563 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  )

friend

Definition at line 568 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  )

friend

Definition at line 573 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  )

friend

Definition at line 579 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