wctomb_s，_wctomb_s_l

将一个宽字符转换为相应的多字节字符。 这是 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
);

参数

pRetValue
字节数或指明结果的代码。

mbchar
多字节字符的地址。

sizeInBytes
mbchar 缓冲区的大小。

wchar
要转换的宽字符。

locale
要使用的区域设置。

返回值

如果成功，返回零；如果失败，则返回错误代码。

错误条件

mbchar	sizeInBytes	返回值	pRetValue
NULL	>0	EINVAL	未修改
any	>INT_MAX	EINVAL	未修改
any	过小	EINVAL	未修改

如果发生上述错误情况中的任何一个，都会调用无效参数处理程序，如参数验证中所述。 如果允许继续执行，则 wctomb 返回 EINVAL，并将 errno 设置为 EINVAL。

返回值 EILSEQ 指示通过参数 wchar 传递的值不是有效的宽字符。

注解

wctomb_s 函数将 wchar 参数转换为相应的多字节字符并将转换结果存储到 mbchar。 可以从任何程序的任何程序点调用该函数。

如果 wctomb_s 将宽字符转换为多字节字符，则会将宽字符的字节数（始终不大于 MB_CUR_MAX）放入 pRetValue 指向的整数。 如果 wchar 为宽字符 null 字符 (L'\0')，wctomb_s 会将 1 填充到 pRetValue。 如果目标指针 mbchar 为 NULL，则 wctomb_s 会将 0 放入 pRetValue。 如果当前区域设置中不支持转换，则 wctomb_s 会将 –1 放入 pRetValue。

wctomb_s 将当前区域设置用于与区域设置相关的信息；_wctomb_s_l 也是一样，只不过它使用传入的区域设置。 有关详细信息，请参阅 Locale。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

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

有关兼容性的详细信息，请参阅 兼容性。

示例

本程序演示 wctomb_s 函数的行为。

// 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 );
}

Convert a wide character:
   Characters converted: 1
   Multibyte character: a

另请参阅

数据转换
区域设置
_mbclen、mblen、_mblen_l
mbstowcs、_mbstowcs_l
mbtowc、_mbtowc_l
wcstombs、_wcstombs_l
WideCharToMultiByte