#include <cstringt.h>

Inheritance diagram for ATL::ChTraitsCRT< _CharType >:

Collaboration diagram for ATL::ChTraitsCRT< _CharType >:

Static Public Member Functions
static int __cdecl	GetBaseTypeLength (_In_z_ LPCWSTR pszSource) noexcept

static int __cdecl	GetBaseTypeLength (_In_z_ LPCSTR pszSource) noexcept

static int __cdecl	GetBaseTypeLength (_In_reads_(nLength) LPCWSTR pszSource, _In_ int nLength) noexcept

static int __cdecl	GetBaseTypeLength (_In_reads_(nLength) LPCSTR pszSource, _In_ int nLength) noexcept

static void __cdecl	ConvertToBaseType (_Out_writes_(nDestLength) LPWSTR pszDest, _In_ int nDestLength, _In_ LPCWSTR pszSrc, _In_ int nSrcLength=-1)

static void __cdecl	ConvertToBaseType (_Out_writes_(nDestLength) LPWSTR pszDest, _In_ int nDestLength, _In_ LPCSTR pszSrc, _In_ int nSrcLength=-1)

static void __cdecl	MakeLower (_Out_writes_(nSrcLength) LPWSTR pszSource, _In_ int nSrcLength)

static DWORD	GetEnvironmentVariable (_In_z_ LPCWSTR pszVar, _Out_writes_opt_(nBufLength) LPWSTR pszBuf, _In_opt_ int nBufLength)

static void __cdecl	MakeUpper (_Out_writes_(nSrcLength) LPWSTR pszSource, _In_ int nSrcLength)

static LPWSTR __cdecl	FindString (_In_z_ LPWSTR pszSource, _In_z_ LPCWSTR pszSub)

static LPCWSTR __cdecl	FindString (_In_z_ LPCWSTR pszSource, _In_z_ LPCWSTR pszSub)

static LPWSTR __cdecl	FindChar (_In_z_ LPWSTR pszSource, _In_ WCHAR ch)

static LPCWSTR __cdecl	FindChar (_In_z_ LPCWSTR pszSource, _In_ WCHAR ch)

static LPWSTR __cdecl	FindCharReverse (_In_z_ LPWSTR pszSource, _In_ WCHAR ch)

static LPCWSTR __cdecl	FindCharReverse (_In_z_ LPCWSTR pszSource, _In_ WCHAR ch)

static LPWSTR __cdecl	FindOneOf (_In_z_ LPWSTR pszSource, _In_z_ LPCWSTR pszCharSet)

static LPCWSTR __cdecl	FindOneOf (_In_z_ LPCWSTR pszSource, _In_z_ LPCWSTR pszCharSet)

static int __cdecl	Compare (_In_z_ LPCWSTR psz1, _In_z_ LPCWSTR psz2)

static int __cdecl	CompareNoCase (_In_z_ LPCWSTR psz1, _In_z_ LPCWSTR psz2)

static int __cdecl	StringSpanIncluding (_In_z_ LPCWSTR pszBlock, _In_z_ LPCWSTR pszSet)

static int __cdecl	StringSpanExcluding (_In_z_ LPCWSTR pszBlock, _In_z_ LPCWSTR pszSet)

static int __cdecl	FormatV (_In_opt_z_ LPWSTR pszDest, _In_z_ LPCWSTR pszFormat, _In_ va_list args)

static LPWSTR	FormatMessageV (_In_z_ LPCWSTR pszFormat, _In_opt_ va_list *pArgList)

static BSTR __cdecl	AllocSysString (_In_z_ LPCWSTR pszSource, _In_ int nLength)

Additional Inherited Members
Public Types inherited from ATL::ChTraitsBase< BaseType >
typedef char	XCHAR

typedef LPSTR	PXSTR

typedef LPCSTR	PCXSTR

typedef wchar_t	YCHAR

typedef LPWSTR	PYSTR

typedef LPCWSTR	PCYSTR

Detailed Description

template<typename _CharType = wchar_t>
class ATL::ChTraitsCRT< _CharType >

Definition at line 25 of file cstringt.h.

Member Function Documentation

◆ AllocSysString()

template<typename _CharType = wchar_t>

static BSTR __cdecl ATL::ChTraitsCRT< _CharType >::AllocSysString	(	_In_z_ LPCWSTR	pszSource,
		_In_ int	nLength
	)

inlinestatic

Definition at line 201 of file cstringt.h.

    {
        return ::SysAllocStringLen(pszSource, nLength);
    }

◆ Compare()

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::Compare	(	_In_z_ LPCWSTR	psz1,
		_In_z_ LPCWSTR	psz2
	)

inlinestatic

Definition at line 153 of file cstringt.h.

    {
        return ::wcscmp(psz1, psz2);
    }

◆ CompareNoCase()

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::CompareNoCase	(	_In_z_ LPCWSTR	psz1,
		_In_z_ LPCWSTR	psz2
	)

inlinestatic

Definition at line 160 of file cstringt.h.

    {
        return ::_wcsicmp(psz1, psz2);
    }

◆ ConvertToBaseType() [1/2]

template<typename _CharType = wchar_t>

static void __cdecl ATL::ChTraitsCRT< _CharType >::ConvertToBaseType	(	_Out_writes_(nDestLength) LPWSTR	pszDest,
		_In_ int	nDestLength,
		_In_ LPCSTR	pszSrc,
		_In_ int	nSrcLength = `-1`
	)

inlinestatic

Definition at line 67 of file cstringt.h.

    {
        if (nSrcLength == -1)
            nSrcLength = 1 + GetBaseTypeLength(pszSrc);
 
        ::MultiByteToWideChar(_AtlGetConversionACP(), 0, pszSrc, nSrcLength, pszDest, nDestLength);
    }

◆ ConvertToBaseType() [2/2]

template<typename _CharType = wchar_t>

static void __cdecl ATL::ChTraitsCRT< _CharType >::ConvertToBaseType	(	_Out_writes_(nDestLength) LPWSTR	pszDest,
		_In_ int	nDestLength,
		_In_ LPCWSTR	pszSrc,
		_In_ int	nSrcLength = `-1`
	)

inlinestatic

Definition at line 55 of file cstringt.h.

    {
        if (nSrcLength == -1)
            nSrcLength = 1 + GetBaseTypeLength(pszSrc);
 
        wmemcpy(pszDest, pszSrc, nSrcLength);
    }

Referenced by ATL::ChTraitsCRT< char >::AllocSysString(), and test_basetypes().

◆ FindChar() [1/2]

template<typename _CharType = wchar_t>

static LPCWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindChar	(	_In_z_ LPCWSTR	pszSource,
		_In_ WCHAR	ch
	)

inlinestatic

Definition at line 120 of file cstringt.h.

    {
        return ::wcschr(pszSource, ch);
    }

◆ FindChar() [2/2]

template<typename _CharType = wchar_t>

static LPWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindChar	(	_In_z_ LPWSTR	pszSource,
		_In_ WCHAR	ch
	)

inlinestatic

Definition at line 114 of file cstringt.h.

    {
        return ::wcschr(pszSource, ch);
    }

◆ FindCharReverse() [1/2]

template<typename _CharType = wchar_t>

static LPCWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindCharReverse	(	_In_z_ LPCWSTR	pszSource,
		_In_ WCHAR	ch
	)

inlinestatic

Definition at line 133 of file cstringt.h.

    {
        return ::wcsrchr(pszSource, ch);
    }

◆ FindCharReverse() [2/2]

template<typename _CharType = wchar_t>

static LPWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindCharReverse	(	_In_z_ LPWSTR	pszSource,
		_In_ WCHAR	ch
	)

inlinestatic

Definition at line 127 of file cstringt.h.

    {
        return ::wcsrchr(pszSource, ch);
    }

◆ FindOneOf() [1/2]

template<typename _CharType = wchar_t>

static LPCWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindOneOf	(	_In_z_ LPCWSTR	pszSource,
		_In_z_ LPCWSTR	pszCharSet
	)

inlinestatic

Definition at line 146 of file cstringt.h.

    {
        return ::wcspbrk(pszSource, pszCharSet);
    }

◆ FindOneOf() [2/2]

template<typename _CharType = wchar_t>

static LPWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindOneOf	(	_In_z_ LPWSTR	pszSource,
		_In_z_ LPCWSTR	pszCharSet
	)

inlinestatic

Definition at line 140 of file cstringt.h.

    {
        return ::wcspbrk(pszSource, pszCharSet);
    }

◆ FindString() [1/2]

template<typename _CharType = wchar_t>

static LPCWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindString	(	_In_z_ LPCWSTR	pszSource,
		_In_z_ LPCWSTR	pszSub
	)

inlinestatic

Definition at line 107 of file cstringt.h.

    {
        return ::wcsstr(pszSource, pszSub);
    }

◆ FindString() [2/2]

template<typename _CharType = wchar_t>

static LPWSTR __cdecl ATL::ChTraitsCRT< _CharType >::FindString	(	_In_z_ LPWSTR	pszSource,
		_In_z_ LPCWSTR	pszSub
	)

inlinestatic

Definition at line 101 of file cstringt.h.

    {
        return ::wcsstr(pszSource, pszSub);
    }

◆ FormatMessageV()

template<typename _CharType = wchar_t>

static LPWSTR ATL::ChTraitsCRT< _CharType >::FormatMessageV	(	_In_z_ LPCWSTR	pszFormat,
		_In_opt_ va_list *	pArgList
	)

inlinestatic

Definition at line 192 of file cstringt.h.

    {
        LPWSTR psz;
        ::FormatMessageW(
            FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_STRING, pszFormat, 0, 0,
            reinterpret_cast<LPWSTR>(&psz), 0, pArgList);
        return psz;
    }

◆ FormatV()

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::FormatV	(	_In_opt_z_ LPWSTR	pszDest,
		_In_z_ LPCWSTR	pszFormat,
		_In_ va_list	args
	)

inlinestatic

Definition at line 181 of file cstringt.h.

    {
        if (pszDest == NULL)
            return ::_vscwprintf(pszFormat, args);
        return ::vswprintf(pszDest, pszFormat, args);
    }

◆ GetBaseTypeLength() [1/4]

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::GetBaseTypeLength	(	_In_reads_(nLength) LPCSTR	pszSource,
		_In_ int	nLength
	)

inlinestaticnoexcept

Definition at line 48 of file cstringt.h.

    {
        return ::MultiByteToWideChar(_AtlGetConversionACP(), 0, pszSource, nLength, NULL, 0);
    }

◆ GetBaseTypeLength() [2/4]

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::GetBaseTypeLength	(	_In_reads_(nLength) LPCWSTR	pszSource,
		_In_ int	nLength
	)

inlinestaticnoexcept

Definition at line 41 of file cstringt.h.

    {
        return nLength;
    }

◆ GetBaseTypeLength() [3/4]

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::GetBaseTypeLength ( _In_z_ LPCSTR pszSource )

inlinestaticnoexcept

Definition at line 35 of file cstringt.h.

    {
        if (pszSource == NULL) return 0;
        return ::MultiByteToWideChar(_AtlGetConversionACP(), 0, pszSource, -1, NULL, 0) - 1;
    }

◆ GetBaseTypeLength() [4/4]

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::GetBaseTypeLength ( _In_z_ LPCWSTR pszSource )

inlinestaticnoexcept

Definition at line 29 of file cstringt.h.

    {
        if (pszSource == NULL) return -1;
        return static_cast<int>(wcslen(pszSource));
    }

Referenced by ATL::ChTraitsCRT< char >::AllocSysString(), ATL::ChTraitsCRT< char >::ConvertToBaseType(), ATL::ChTraitsCRT< _CharType >::ConvertToBaseType(), and test_basetypes().

◆ GetEnvironmentVariable()

template<typename _CharType = wchar_t>

static DWORD ATL::ChTraitsCRT< _CharType >::GetEnvironmentVariable	(	_In_z_ LPCWSTR	pszVar,
		_Out_writes_opt_(nBufLength) LPWSTR	pszBuf,
		_In_opt_ int	nBufLength
	)

inlinestatic

Definition at line 86 of file cstringt.h.

    {
        return ::GetEnvironmentVariableW(pszVar, pszBuf, nBufLength);
    }

◆ MakeLower()

template<typename _CharType = wchar_t>

static void __cdecl ATL::ChTraitsCRT< _CharType >::MakeLower	(	_Out_writes_(nSrcLength) LPWSTR	pszSource,
		_In_ int	nSrcLength
	)

inlinestatic

Definition at line 79 of file cstringt.h.

    {
        ::CharLowerBuffW(pszSource, nSrcLength);
    }

◆ MakeUpper()

template<typename _CharType = wchar_t>

static void __cdecl ATL::ChTraitsCRT< _CharType >::MakeUpper	(	_Out_writes_(nSrcLength) LPWSTR	pszSource,
		_In_ int	nSrcLength
	)

inlinestatic

Definition at line 94 of file cstringt.h.

    {
        ::CharUpperBuffW(pszSource, nSrcLength);
    }

◆ StringSpanExcluding()

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::StringSpanExcluding	(	_In_z_ LPCWSTR	pszBlock,
		_In_z_ LPCWSTR	pszSet
	)

inlinestatic

Definition at line 174 of file cstringt.h.

    {
        return (int)::wcscspn(pszBlock, pszSet);
    }

◆ StringSpanIncluding()

template<typename _CharType = wchar_t>

static int __cdecl ATL::ChTraitsCRT< _CharType >::StringSpanIncluding	(	_In_z_ LPCWSTR	pszBlock,
		_In_z_ LPCWSTR	pszSet
	)

inlinestatic

Definition at line 167 of file cstringt.h.

    {
        return (int)::wcsspn(pszBlock, pszSet);
    }

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

sdk/lib/atl/cstringt.h

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AllocSysString()

◆ Compare()

◆ CompareNoCase()

◆ ConvertToBaseType() [1/2]

◆ ConvertToBaseType() [2/2]

◆ FindChar() [1/2]

◆ FindChar() [2/2]

◆ FindCharReverse() [1/2]

◆ FindCharReverse() [2/2]

◆ FindOneOf() [1/2]

◆ FindOneOf() [2/2]

◆ FindString() [1/2]

◆ FindString() [2/2]

◆ FormatMessageV()

◆ FormatV()

◆ GetBaseTypeLength() [1/4]

◆ GetBaseTypeLength() [2/4]

◆ GetBaseTypeLength() [3/4]

◆ GetBaseTypeLength() [4/4]

◆ GetEnvironmentVariable()

◆ MakeLower()

◆ MakeUpper()

◆ StringSpanExcluding()

◆ StringSpanIncluding()