宽字节与多字节互相转换

Posted 牠说,要陪你走过春夏秋冬;牠必不食言

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了宽字节与多字节互相转换相关的知识,希望对你有一定的参考价值。

这里需要用到两个函数:WideCharToMultiByte 与 MultiByteToWideChar

前者是从宽字节转换为多字节,后者则相反,是从多字节转换为宽字节。下面介绍下这两个函数:

 

WideCharToMultiByte

该函数可以映射一个unicode字符串到一个多字节字符串,执行转换的代码页、接收转换字符串、允许额外的控制等操作。

WideCharToMultiByte(
_In_ UINT CodePage,   // 指定执行转换的代码页,这个参数可以为系统已安装或有效的任何代码页所给定的值
_In_ DWORD dwFlags, // 一组位标记用以指出是否未转换成预作或宽字符(若组合形式存在),是否使用象形文字替代控制字符,以及如何处理无效字符
_In_NLS_string_(cchWideChar) LPCWCH lpWideCharStr, // 指向将被转换的unicode字符串
_In_ int cchWideChar, // 指定由参数lpWideCharStr指向的缓冲区的字符个数。如果这个值为-1,字符串将被设定为以NULL为结束符的字符串,并且自动计算长度
_Out_writes_bytes_to_opt_(cbMultiByte, return) LPSTR lpMultiByteStr,// 指向接收被转换字符串的缓冲区   
_In_ int cbMultiByte, // 指定由参数lpMultiByteStr指向的缓冲区最大值(用字节来计量)。若此值为零,函数返回lpMultiByteStr指向的目标缓冲区所必需的字节数,在这种情况下,lpMultiByteStr参数通常为NULL
_In_opt_ LPCCH lpDefaultChar, // 遇到一个不能转换的宽字符,函数便会使用pDefaultChar参数指向的字符
_Out_opt_ LPBOOL lpUsedDefaultChar // 至少有一个字符不能转换为其多字节形式,函数就会把这个变量设为TRUE
);

需要注意最后两个参数lpDefaultChar和pfUsedDefaultChar:只有当WideCharToMultiByte函数遇到一个宽字节字符,而该字符在uCodePage参数标识的代码页中并没有它的表示法时,WideCharToMultiByte函数才使用这两个参数。如果宽字节字符不能被转换,该函数便使用lpDefaultChar参数指向的字符。如果该参数是NULL(这是大多数情况下的参数值),那么该函数使用系统的默认字符。该默认字符通常是个问号。这对于文件名来说是危险的,因为问号是个通配符。pfUsedDefaultChar参数指向一个布尔变量,如果Unicode字符串中至少有一个字符不能转换成等价多字节字符,那么函数就将该变量置为TRUE。如果所有字符均被成功地转换,那么该函数就将该变量置为FALSE。当函数返回以便检查宽字节字符串是否被成功地转换后,可以测试该变量。

返回值:如果函数运行成功,并且cchMultiByte不为零,返回值是由 lpMultiByteStr指向的缓冲区中写入的字节数;如果函数运行成功,并且cchMultiByte为零,返回值是接收到待转换字符串的缓冲区所必需的字节数。如果函数运行失败,返回值为零。

 

MultiByteToWideChar

该函数可以映射一个多字节字符串到一个unicode字符串

MultiByteToWideChar(
    _In_ UINT CodePage,  // 指定执行转换的字符集,这个参数可以为系统已安装或有效的任何字符集所给定的值
    _In_ DWORD dwFlags,  // 一组位标记用以指出是否未转换成预作或宽字符(若组合形式存在),是否使用象形文字替代控制字符,以及如何处理无效字符。
    _In_NLS_string_(cbMultiByte) LPCCH lpMultiByteStr,  // 指向将被转换字符串的字符。
    _In_ int cbMultiByte,  // 指定将被转换的字符串中字节的个数。如果lpMultiByteStr指定的字符串以空字符终止,可以设置为-1(如果字符串不是以空字符中止,设置为-1可能失败,可能成功),此参数设置为0函数将失败。
    _Out_writes_to_opt_(cchWideChar, return) LPWSTR lpWideCharStr,  // 指向接收被转换字符串的缓冲区
    _In_ int cchWideChar  // 指定接收被转换字符串缓冲区的宽字符个数。若此值为零,函数返回缓冲区所必需的宽字符数,在这种情况下,lpWideCharStr中的缓冲区不被使用。
    );

返回值:如果函数运行成功,并且cchWideChar不为零,返回值是由lpWideCharStr指向的缓冲区中写入的宽字符数;如果函数运行成功,并且cchWideChar为零,返回值是接收到待转换字符串的缓冲区所需求的宽字符数大小。如果函数运行失败,返回值为零。

 

/************************************************************************/
/* Project:    宽字节与多字节互相转换                                        */
/* Author:    LandyTan                                                    */
/* Time:    2017/11/04                                                    */
/************************************************************************/


#include <iostream>
#include <Windows.h>
using namespace std;


char* _WTA(__in wchar_t* pszInBufBuf, __in int nInSize, __out char** pszOutBuf, __out int* pnOutSize);
wchar_t* _ATW(__in char* pszInBuf, __in int nInSize, __out wchar_t** pszOutBuf, __out int* pnOutSize);


int main()
{
    {
        char* pszIn = "Hello";
        wchar_t* pszOut = NULL;
        int nOutSize = 0;
        if (!_ATW(pszIn, strlen(pszIn), &pszOut, &nOutSize))
            cerr << "多字节转宽字节失败" << endl;
        else cout << "多字节:" << pszIn << "\t宽字节:" << pszOut << endl;
        delete[] pszOut;
        pszOut = NULL;
    }

    {
        wchar_t* pszIn = L"Hello";
        char* pszOut = NULL;
        int nOutSize = 0;
        if (!_WTA(pszIn, wcslen(pszIn), &pszOut, &nOutSize))
            cerr << "宽字节转多字节失败" << endl;
        else cout << "宽字节:" << pszIn << "\t多字节:" << pszOut << endl;
        delete[] pszOut;
        pszOut = NULL;
    }
    
    system("pause");
    return 0;
}


/************************************************************************/
/* Name:        _ATW                                                    */
/* Function:    多字节转宽字节                                            */
/* Parameter list:                                                        */
/*                pszInBuf        被转换的字符串                            */
/*                nInSize            字符串长度                                */
/*                pszOutBuf        接收转换的字符串                            */
/*                pnOutSize        接收字符串的长度                            */
/************************************************************************/
wchar_t* _ATW(__in char* pszInBuf, __in int nInSize, __out wchar_t** pszOutBuf, __out int* pnOutSize)
{
    if(!pszInBuf || !pszOutBuf || !pnOutSize || nInSize <= 0)return NULL;
    *pnOutSize = MultiByteToWideChar(NULL, NULL, pszInBuf, nInSize, *pszOutBuf, 0);// 获取待转换字符串的缓冲区所需大小
    if(*pnOutSize == 0)return NULL;
    (*pnOutSize)++;
    *pszOutBuf = new wchar_t[*pnOutSize];
    memset((void*)*pszOutBuf, 0, sizeof(wchar_t) * (*pnOutSize));
    if(MultiByteToWideChar(NULL, NULL, pszInBuf, nInSize, *pszOutBuf, *pnOutSize) == 0)  // 这里才是转换
        return NULL;
    else return *pszOutBuf;
}


/************************************************************************/
/* Name:        _WTA                                                    */
/* Function:    宽字节转多字节                                            */
/* Parameter list:                                                        */
/*                pszInBuf        被转换的字符串                            */
/*                nInSize            字符串长度                                */
/*                pszOutBuf        接收转换的字符串                            */
/*                pnOutSize        接收字符串的长度                            */
/************************************************************************/
char* _WTA(__in wchar_t* pszInBuf, __in int nInSize, __out char** pszOutBuf, __out int* pnOutSize)
{
    if(!pszInBuf || !pszOutBuf || !pnOutSize || nInSize <= 0)return NULL;
    *pnOutSize = WideCharToMultiByte(NULL, NULL, pszInBuf, nInSize, *pszOutBuf, 0, NULL, NULL);// 获取待转换字符串的缓冲区所需大小
    if(*pnOutSize == 0)return NULL;
    (*pnOutSize)++;
    *pszOutBuf = new char[*pnOutSize];
    memset((void*)*pszOutBuf, 0, sizeof(char)* (*pnOutSize));
    if (WideCharToMultiByte(NULL, NULL, pszInBuf, nInSize, *pszOutBuf, *pnOutSize, NULL, NULL) == 0) // 这里才是转换
        return NULL;
    else return *pszOutBuf;
}

 

以上是关于宽字节与多字节互相转换的主要内容,如果未能解决你的问题,请参考以下文章

跨平台字符处理

windows下多字节和宽字节转换

宽字节UTF-8多字节互转

判断主机网络字节序和互相转换

宽字符到多字节问题

SQL注入 | 宽字节注入2