wctomb， _wctomb_l

项目
02/21/2013

将宽字符转换为相应的多字节字符。这些功能的更安全版本可用; 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 是宽字符 null 字符 (L' \ 0 ")， wctomb 返回 1。如果目标指针 mbchar 为空， 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 );
}