%>

将一个宽字符转换为相应的多字节字符。 这是 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。 如果目标指针 mbcharNULL,则 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

另请参阅

数据转换
区域设置
.- .
%>
%>
%>
WideCharToMultiByte