mbrtowc

转换多字节字符转换为等效的宽字符。

size_t mbrtowc(
   wchar_t *wchar,
   const char *mbchar,
   size_t count,
   mbstate_t mbstate
);

参数

• wchar
  接收转换后的宽字符字符串的宽字符的地址 (类型 wchar_t)。; 如果没有返回宽字符需要，该值可以是 NULL 。

• mbchar
  序列的地址字节 (多字节字符)。

• count
  检查的字节数。

• mbstate
  转换状态。如果此值为空，使用内部转换状态类别。

返回值

• 0
  如果下 count 或更低字节完成表示 NULL 宽字符的多字节字符。

• > 0
  如果下 count 或更低字节完成有效的多字节字符，返回的值是完成多字节字符的字节数。

• -1
  如果编码错误，，在下 count 或更低字节不会导致完整有效的多字节字符情况下， errno 值将为 EILSEQ 和不明确转换的状态。

• -2
  如果下一个 count 字节导致不完整的多字节和所有计数字节处理。

备注

如果 wchar空值，将函数与调用等效:

mbrtowc(NULL, NULL, 1, mbstate)

在这种情况下，参数 wchar 的值和 count 被忽略。

如果 wchar 不为空，该功能检查从 mbchar的 count 字节命令式所需的字节数完成下多字节字符。如果下一个字符是有效的，对应的多字节字符在 wchar 存储，如果不为空。如果该字符是相应的宽度 null 字符，结果状态是初始转换状态。

mbrtowc 功能与 mbtowc， _mbtowc_l 不同由其 restartability。转换状态中的 mbstate 存储的后续调用相同或其他可重新启动的功能。，混合使用可重新启动和 nonrestartable 函数时，结果是未定义的。例如，因此，如果以后对 wcsrtombs 效果位置而不是 wcstombs，应用程序将使用 wcsrlen 而不是 wcslen。

示例

转换多字节字符转换为宽字符等效。

// crt_mbrtowc.cpp

#include <stdio.h>
#include <mbctype.h>
#include <string.h>
#include <locale.h>
#include <wchar.h>

#define BUF_SIZE 100

int Sample(char* szIn, wchar_t* wcOut, int nMax)
{
    mbstate_t   state = {0}; // Initial state
    size_t      nConvResult, 
                nmbLen = 0,
                nwcLen = 0;
    wchar_t*    wcCur = wcOut;
    wchar_t*    wcEnd = wcCur + nMax;
    const char* mbCur = szIn;
    const char* mbEnd = mbCur + strlen(mbCur) + 1;
    char*       szLocal;
    
    // Sets all locale to French_Canada.1252
    szLocal = setlocale(LC_ALL, "French_Canada.1252");
    if (!szLocal)
    {
        printf("The fuction setlocale(LC_ALL, \"French_Canada.1252\") failed!\n");
        return 1;
    }

    printf("Locale set to: \"%s\"\n", szLocal);

    // Sets the code page associated current locale's code page
    // from a previous call to setlocale.
    if (_setmbcp(_MB_CP_SBCS) == -1)
    {
        printf("The fuction _setmbcp(_MB_CP_SBCS) failed!");
        return 1;
    }

    while ((mbCur < mbEnd) && (wcCur < wcEnd))
    {
        //
        nConvResult = mbrtowc(wcCur, mbCur, 1, &state);
        switch (nConvResult)
        {
            case 0:
            {  // done
                printf("Conversion succeeded!\nMultibyte String: ");
                printf(szIn);
                printf("\nWC String: ");
                wprintf(wcOut);
                printf("\n");
                mbCur = mbEnd;
                break;
            }

            case -1:
            {  // encoding error
                printf("The call to mbrtowc has detected an encoding error.\n");
                mbCur = mbEnd;
                break;
            }

            case -2:
            {  // incomplete character
                if   (!mbsinit(&state))
                {
                    printf("Currently in middle of mb conversion, state = %x\n", state);
                    // state will contain data regarding lead byte of mb character
                }

                ++nmbLen;
                ++mbCur;
                break;
            }

            default:
            {
                if   (nConvResult > 2) // The multibyte should never be larger than 2
                {
                    printf("Error: The size of the converted multibyte is %d.\n", nConvResult);
                }

                ++nmbLen;
                ++nwcLen;
                ++wcCur;
                ++mbCur;
            break;
            }
        }
    }

   return 0;
}

int main(int argc, char* argv[])
{
    char    mbBuf[BUF_SIZE] = "AaBbCc\x9A\x8B\xE0\xEF\xF0xXyYzZ";
    wchar_t wcBuf[BUF_SIZE] = {L''};

    return Sample(mbBuf, wcBuf, BUF_SIZE);
}

示例输出

Locale set to: "French_Canada.1252"
Conversion succeeded!
Multibyte String: AaBbCcÜïα∩≡xXyYzZ
WC String: AaBbCcÜïα∩≡xXyYzZ

要求

实例	必需的头
mbrtowc	wchar.h

.NET Framework 等效项

不适用。若要调用标准 C 函数，请使用 PInvoke。有关更多信息，请参见 平台调用示例。

请参见

参考

数据转换

区域设置

多字节字符序列的说明