wctomb、_wctomb_l

项目
06/09/2015

将一个宽字符转换为相应的多字节字符。提供这些函数的更多安全版本；请参见 wctomb_s、_wctomb_s_l。

int wctomb(
   char *mbchar,
   wchar_t wchar 
);
int _wctomb_l(
   char *mbchar,
   wchar_t wchar,
   _locale_t locale
);

参数

mbchar
一个多字节字符的地址。
wchar
一个宽字符。

返回值

如果 wctomb 将宽字符为多字节字符，则返回宽字符的字节数(不超过MB_CUR_MAX) 。如果 wchar 是宽字符的空字符 (L'\0')，wctomb 返回 1。如果目标指针mbchar是NULL，wctomb 返回 0。如果当前区域设置不允许转换，wctomb 返回 -1，并将errno 设置为 EILSEQ。

备注

wctomb 函数将其 wchar 参数转换为对应的多字节字符并将结果存储在 mbchar。在所有程序可以调用从任意点的函数。 wctomb使用区域设置相关行为的当前区域设置；_wctomb_l和 wctomb相同，但它将使用传递的区域设置。有关详细信息，请参阅区域设置。

wctomb验证其参数。如果 mbchar 是 NULL，则会调用无效参数处理程序，如参数验证中所述。如果允许执行继续，errno设置为EINVAL，并且函数返回-1。

要求

例程	必需的标头
wctomb	<stdlib.h>

有关其他兼容性信息，请参见“简介”中的兼容性。

示例

此程序阐述wctomb函数的行为。

// crt_wctomb.cpp
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   int i;
   wchar_t wc = L'a';
   char *pmb = (char *)malloc( MB_CUR_MAX );

   printf( "Convert a wide character:\n" );
   i = wctomb( pmb, wc ); // C4996
   // Note: wctomb is deprecated; consider using wctomb_s
   printf( "   Characters converted: %u\n", i );
   printf( "   Multibyte character: %.1s\n\n", pmb );
}