wcrtomb, wcrtomb_s
来自 cppreference.cn
| 在头文件 <wchar.h> 中定义 |
||
| (1) | ||
| (自 C95 起) | ||
| (C99 起) | ||
| (2) | (C11 起) | |
将宽字符转换为其窄多字节表示。
1) 如果
s 不是空指针，该函数确定存储 wc 的多字节字符表示所需的字节数（包括任何移位序列，并考虑当前的多字节转换状态 *ps），并将多字节字符表示存储在第一个元素由 s 指向的字符数组中，必要时更新 *ps。此函数最多可写入 MB_CUR_MAX 字节。 如果
s 是空指针，则此调用等效于 wcrtomb(buf, L'\0', ps)，其中 buf 是某个内部缓冲区。 如果 wc 是空宽字符 L'\0'，则存储一个空字节，前面是恢复初始移位状态所需的任何移位序列，并且转换状态参数 *ps 被更新以表示初始移位状态。
如果定义了环境宏 __STDC_ISO_10646__，则类型 wchar_t 的值与 Unicode 必需集中字符的短标识符相同（通常是 UTF-32 编码）；否则，它是实现定义的。在任何情况下，此函数使用的多字节字符编码由当前活动的 C 语言环境指定。
2) 与(1)相同，但：
如果
s 是空指针，则此调用等效于 wcrtomb_s(&retval, buf, sizeof buf, L'\0', ps)，其中 retval 和 buf 是内部变量（其大小大于 MB_CUR_MAX） 结果在输出参数
retval 中返回 以下错误在运行时被检测到并调用当前安装的约束处理程序函数
-
retval或ps是空指针。 -
ssz为零或大于 RSIZE_MAX（除非s为空） -
ssz小于将要写入的字节数（除非s为空） -
s是空指针但ssz不为零
-
- 与所有边界检查函数一样，
wcrtomb_s仅在实现定义了 __STDC_LIB_EXT1__ 且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时才保证可用。
目录 |
[edit] 参数
| s | - | 指向窄字符数组的指针，多字节字符将存储在此处 |
| wc | - | 要转换的宽字符 |
| ps | - | 指向转换状态对象的指针，用于解释多字节字符串 |
| ssz | - | 要写入的最大字节数（缓冲区 s 的大小） |
| retval | - | 指向输出参数的指针，结果（多字节字符串中的字节数，包括任何移位序列）将存储在此处 |
[edit] 返回值
1) 成功时，返回写入到第一个元素由
s 指向的字符数组的字节数（包括任何移位序列）。2) 成功时返回零，失败时返回非零，在此情况下，s[0] 被设置为 '\0'（除非
s 为空或 ssz 为零或大于 RSIZE_MAX）并且 *retval 被设置为 (size_t)-1（除非 retval 为空）[edit] 示例
运行此代码
#include <stdio.h> #include <locale.h> #include <string.h> #include <wchar.h> #include <stdlib.h> int main(void) { setlocale(LC_ALL, "en_US.utf8"); mbstate_t state; memset(&state, 0, sizeof state); wchar_t in[] = L"zß水🍌"; // or "z\u00df\u6c34\U0001F34C" size_t in_sz = sizeof in / sizeof *in; printf("Processing %zu wchar_t units: [ ", in_sz); for(size_t n = 0; n < in_sz; ++n) printf("%#x ", (unsigned int)in[n]); puts("]"); char out[MB_CUR_MAX * in_sz]; char *p = out; for(size_t n = 0; n < in_sz; ++n) { int rc = wcrtomb(p, in[n], &state); if(rc == -1) break; p += rc; } size_t out_sz = p - out; printf("into %zu UTF-8 code units: [ ", out_sz); for(size_t x = 0; x < out_sz; ++x) printf("%#x ", +(unsigned char)out[x]); puts("]"); }
输出
Processing 5 wchar_t units: [ 0x7a 0xdf 0x6c34 0x1f34c 0 ] into 11 UTF-8 code units: [ 0x7a 0xc3 0x9f 0xe6 0xb0 0xb4 0xf0 0x9f 0x8d 0x8c 0 ]
