mbtowc, _mbtowc_l

转换多字节字符转换为相应的宽字符。

int mbtowc(
   wchar_t *wchar,
   const char *mbchar,
   size_t count 
);
int _mbtowc_l(
   wchar_t *wchar,
   const char *mbchar,
   size_t count,
   _locale_t locale
);

参数

  • wchar
    宽字符 (类型 wchar_t) 的地址。

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

  • 计数
    检查的字节数。

  • 区域设置
    使用的区域设置。

返回值

如果 mbchar 不是 NULL ,并且,如果 mbchar 指向窗体有效的多字节字符的对象, mbtowc 在多字节字符的字节返回长度。 如果 mbchar 是 NULL 或所指向的对象是宽字符 null 字符 (L' \ 0 "),该函数返回 0。 如果 mbchar 所指向的对象不能构成在第一 计数 字符内的有效字节字符,则返回 – 1。

备注

mbtowc 函数转换 次数 或更低字节指向由 mbchar,因此,如果 mbchar 不是 NULL,为相应的宽字符。 mbtowc 存储发生的宽字符在 wchar, 因此,如果 wchar 不是 NULLmbtowcMB_CUR_MAX 字节不检查更多。mbtowc 对区域设置相关的行为使用当前区域设置; _mbtowc_l 与相同,但它使用的区域设置。 有关更多信息,请参见 区域设置

要求

实例

必需的头

mbtowc

stdlib.h

_mbtowc_l

stdlib.h

有关其他的兼容性信息,请参见中介绍的 兼容性

C 运行库的所有版本。

示例

// crt_mbtowc.c
/* Illustrates the behavior of the mbtowc function
 */

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *pmbc    = (char *)malloc( sizeof( char ) );
    wchar_t  wc      = L'a';
    wchar_t *pwcnull = NULL;
    wchar_t *pwc     = (wchar_t *)malloc( sizeof( wchar_t ) );
    printf( "Convert a wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "  Characters converted: %u\n", i );
    printf( "  Multibyte character: %x\n\n", *pmbc );

    printf( "Convert multibyte character back to a wide "
            "character:\n" );
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
    printf( "  Wide character: %x\n\n", *pwc );
    printf( "Attempt to convert when target is NULL\n" );
    printf( "  returns the length of the multibyte character:\n" );
    i = mbtowc( pwcnull, pmbc, MB_CUR_MAX );
    printf( "  Length of multibyte character: %u\n\n", i );

    printf( "Attempt to convert a NULL pointer to a" );
    printf( " wide character:\n" );
    pmbc = NULL;
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
}

Output

Convert a wide character to multibyte character:
  Characters converted: 1
  Multibyte character: 61

Convert multibyte character back to a wide character:
  Bytes converted: 1
  Wide character: 61

Attempt to convert when target is NULL
  returns the length of the multibyte character:
  Length of multibyte character: 1

Attempt to convert a NULL pointer to a wide character:
  Bytes converted: 0

.NET Framework 等效项

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

请参见

参考

数据转换

MultiByteToWideChar

区域设置

多字节字符序列的说明

_mbclen, mblen, _mblen_l

wcstombs, _wcstombs_l

wctomb, _wctomb_l