ATL字符串转换类

字符串的ASCII和UNICODE之间的转换很常用，Win32提供了API函数MultiByteToWideChar和WideCharToMultiByte来提供这种功能。但凡Win32的API，参数调用都不会少，因此使用起来也就觉得有点繁琐。ATL3中提供了字符串转换宏，如T2W、A2T等,不过使用它们需要借助本地变量,因此在使用之前需要声明USES_CONVERSION宏来声明本地变量.而且还有个很大的缺陷:转换宏总是使用栈存储,它们在运行时调用_alloca在本地栈上分配额外的空间,如果在函数中循环地进行转换,很可能因为栈空间用尽而崩溃,因为栈空间在函数退出后才能释放。还有个很严重的问题:若在C++ catch块中使用转换宏,_alloca调用会搅乱栈上的异常跟踪信息而使程序崩溃。

ATL还提供了另一套转换宏:_Ex系列,使用如刚才提到的一样,使用前需声明本地变量，通过USES_CONVERSION_EX宏声明,继而调用T2W_EX、W2A_EX等宏，不过这些宏需要提供2个参数,第一个参数同上,第二个参数指定一个界值,如果转换缓冲小于这个值,则通过_alloca在栈上分配内存,若缓冲大于指定的值，则在堆上分配，因此可以避免栈溢出。但其在C++ catch块中仍然无能为力.

在ATL7中引入了字符串转换类,所有的类采用统一的命名格式:C<源格式简写>2<目标格式简写>,如CA2W用于将ASCII格式的字符串转换为UNICODE格式.具体的有:CA2W、CA2T、CA2WEX、CA2CT、CW2T、CW2A、CW2AWX等等，实际上真正完成ASCII到UNICODE之间的转换的只有CA2WEX和CW2AEX两个类,以CW2AEX为例简单地介绍一下,首先看其源码:

template< int t_nBufferLength = 128 >
class CW2AEX
{
public:
    CW2AEX( __in_opt LPCWSTR psz ) throw() :
        m_psz( m_szBuffer )
    {
        Init( psz, _AtlGetConversionACP() );
    }
    CW2AEX( __in_opt LPCWSTR psz, UINT nCodePage ) throw() :
        m_psz( m_szBuffer )
    {
        Init( psz, nCodePage );
    }
    ~CW2AEX() throw()
    {        
        AtlConvFreeMemory(m_psz,m_szBuffer,t_nBufferLength);
    }

    operator LPSTR() const throw()
    {
        return( m_psz );
    }

private:
    void Init( __in_opt LPCWSTR psz, __in UINT nConvertCodePage ) throw()
    {
        if (psz == NULL)
        {
            m_psz = NULL;
            return;
        }
        int nLengthW = lstrlenW( psz )+1;         
        int nLengthA = nLengthW*4;
        
        AtlConvAllocMemory(&m_psz,nLengthA,m_szBuffer,t_nBufferLength);

        BOOL bFailed=(0 == ::WideCharToMultiByte( nConvertCodePage, 0, psz, nLengthW, m_psz, nLengthA, NULL, NULL ));
        if (bFailed)
        {
            if (GetLastError()==ERROR_INSUFFICIENT_BUFFER)
            {
                nLengthA = ::WideCharToMultiByte( nConvertCodePage, 0, psz, nLengthW, NULL, 0, NULL, NULL );
                AtlConvAllocMemory(&m_psz,nLengthA,m_szBuffer,t_nBufferLength);
                bFailed=(0 == ::WideCharToMultiByte( nConvertCodePage, 0, psz, nLengthW, m_psz, nLengthA, NULL, NULL ));
            }            
        }
        if (bFailed)
        {
            AtlThrowLastWin32();
        }
    }

public:
    LPSTR m_psz;
    char m_szBuffer[t_nBufferLength];

private:
    CW2AEX( const CW2AEX& ) throw();
    CW2AEX& operator=( const CW2AEX& ) throw();
};

其有个模板参数t_nBufferLength用于指定缓冲的字符数组的大小,在Init方法中调用AtlConvAllocMemory方法来分配缓冲内存,如果所需的缓冲大小超过了t_nBufferLength设定的值,那么将调用calloc/_recalloc在堆上分配内存缓冲。

使用这些转换类十分方便，不在需要本地变量,Demo如下:

    void  testDemo( LPCTSTR lpszDemo ){}

    //调用
    testDemo( CW2T( L"test string" ) );

 

参考资料: 《深入解析ATL(第2版)》