WCTOMB - Linux手册页

时间:2019-08-20 18:01:39  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2015-08-08

名称

wctomb-将宽字符转换为多字节序列

语法

#include <stdlib.h>

int wctomb(char *s, wchar_t wc);

说明

如果s不为NULL,则wctomb()函数将宽字符wc转换为其多字节表示形式,并将其存储在s指向的字符数组的开头。它更新移位状态,该状态存储在仅wctomb()函数已知的静态匿名变量中,并返回所述多字节表示形式的长度,即,写入s的字节数。

程序员必须确保在s处至少有MB_CUR_MAX个字节的空间。

如果s为NULL,则wctomb()函数会将仅此函数已知的移位状态重置为初始状态,如果编码具有非平凡的移位状态,则返回非零;如果编码为无状态,则返回零。

返回值

如果s不为NULL,则wctomb()函数返回已在s处写入字节数组的字节数。如果wc不能表示为多字节序列(根据当前语言环境),则返回-1。

如果s为NULL,则wctomb()函数如果编码具有非平移状态,则返回非零;如果编码为无状态,则返回零。

属性

有关本节中使用的术语的说明,请参见attribute(7)。

InterfaceAttributeValue
wctomb()Thread safetyMT-Unsafe race

遵循规范

POSIX.1-2001,POSIX.1-2008,C99。

备注

wctomb()的行为取决于当前语言环境的LC_CTYPE类别。

函数wcrtomb(3)为相同的功能提供了更好的接口。

另外参见

MB_CUR_MAX(3),mblen(3),mbstowcs(3),mbtowc(3),wcrtomb(3),wcstombs(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/