wctomb_s， _wctomb_s_l

项目
02/21/2013

将宽字符转换为相应的多字节字符。 wctomb， _wctomb_l 的版本与安全增强的 CRT中的安全功能如中所述。

errno_t wctomb_s(
   int *pRetValue,
   char *mbchar,
   size_t sizeInBytes,
   wchar_t wchar 
);
errno_t _wctomb_s_l(
   int *pRetValue,
   char *mbchar,
   size_t sizeInBytes,
   wchar_t wchar,
   _locale_t locale
);

参数

[out] pRetValue
字节数或指示结果的代码。
[out] mbchar
多字节字符的地址。
[in] sizeInBytes
缓冲区 mbchar的大小。
[in] wchar
宽字符。
[in] locale
使用的区域设置。

返回值

零，如果成功，则失败的错误代码。

错误状态

mbchar	sizeInBytes	返回值	pRetValue
NULL	>0	EINVAL	不修改
任何	AMP_GTINT_MAX	EINVAL	不修改
任何	太小	EINVAL	不修改

如果任何一个上述错误状态，当无效参数调用处理程序，如参数验证所述。如果执行允许继续， wctomb 返回 EINVAL 并将 errno 到 EINVAL。

备注

wctomb_s 函数将其 wchar 参数转换为相应的多字节字符并将结果存储在 mbchar。在所有程序可以从任何函数点。

如果 wctomb_s 转换宽字符转换为字节字符，它在宽字符放置 (比 MB_CUR_MAX不高) 的字节数为整数指向由 pRetValue。如果 wchar 是宽字符 null 字符 (L' \ 0 ")， wctomb_s 用 1. 加载 pRetValue 。如果目标指针 mbchar 为空， wctomb_s 在 pRetValue放置 0。如果转换不适用于当前区域设置， wctomb_s 放置 – 1 在 pRetValue。

wctomb_s 使用当前区域设置对于区域设置相关的信息; _wctomb_s_l 与相同，但它使用的区域设置。有关更多信息，请参见区域设置。

要求

实例	必需的头
wctomb_s	stdlib.h
_wctomb_s_l	stdlib.h

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

示例

此过程说明 wctomb 功能的行为。

// crt_wctomb_s.cpp
#include <stdio.h>
#include <stdlib.h>

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

    printf_s( "Convert a wide character:\n" );
    wctomb_s( &i, pmb, MB_CUR_MAX, wc );
    printf_s( "   Characters converted: %u\n", i );
    printf_s( "   Multibyte character: %.1s\n\n", pmb );
}