wctomb_s

wctomb, wctomb_s

1）将宽字符转换wc为多字节编码并将其存储在第一个元素指向的char数组中（包括任何移位序列）s。不超过MB_CUR_MAX字符存储。

如果wc是空字符，则写入空字节s，之前是恢复初始移位状态所需的任何移位序列。

如果s是空指针，则此函数会重置全局转换状态并确定是否使用移位序列。

2）与（1）相同，除了在out参数中返回结果status并在运行时检测到以下错误并调用当前安装的约束处理函数：

• ssz小于将被写入的字节数（除非s为空）

作为所有边界检查函数，wctomb_s只有在被__STDC_LIB_EXT1__实现定义__STDC_WANT_LIB_EXT1__并且1在包含之前用户定义为整数常量时才能保证可用stdlib.h。

注意

每次调用都会wctomb更新内部全局转换状态（类型的静态对象mbstate_t，只有该函数已知）。如果多字节编码使用移位状态，则此功能不可重入。在任何情况下，多个线程都不应该在wctomb没有同步的情况下调用：wcrtomb或者wctomb_s可以用来代替。

与大多数边界检查函数不同，wctomb_s它不会空结束它的输出，因为它被设计用于逐字符处理字符串的循环中。

参数

返回值

1）如果s不是空指针，则返回多字节表示中包含的字节数，wc或者-1如果wc不是有效字符。

如果s是空指针，则重置其内部转换状态以表示初始移位状态，​0​如果当前多字节编码不是状态相关（不使用移位序列），则返回表示状态，如果当前多字节编码状态不变，则返回非零值；（使用移位序列）。

2）成功为零，在这种情况下，多字节表示wc被存储在其中，s并且其长度被存储*status，或者如果s为空，则将转换序列状态存储在status）中。编码错误或运行时约束违规（在这种情况下(size_t)-1存储在其中）时非零*status。存储的值*status永远不会超过MB_CUR_MAX

示例

​

#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
 
void demo(wchar_t wc)
{
    printf("State-dependent encoding?   %d\n", wctomb(NULL, wc)
 
    char mb[MB_CUR_MAX];
    int len = wctomb(mb,wc
    printf("wide char '%lc' -> multibyte char '", wc
    for (int idx = 0; idx < len; ++idx)
        printf("%#2x ", (unsigned char)mb[idx]
    printf("'\n"
}
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8"
    printf("MB_CUR_MAX = %zu\n", MB_CUR_MAX
    demo(L'A'
    demo(L'\u00df'
    demo(L'\U0001d10b'
}

​

可能的输出：

​

MB_CUR_MAX = 6
State-dependent encoding?   0
wide char 'A' -> multibyte char '0x41 '
State-dependent encoding?   0
wide char 'ß' -> multibyte char '0xc3 0x9f '
State-dependent encoding?   0
wide char '?' -> multibyte char '0xf0 0x9d 0x84 0x8b '

​

参考

• C11标准（ISO/IEC 9899:2011）：

另请参阅

| 用于wctomb |的C ++文档