wctomb
来自cppreference.com
 |
该页由英文版wiki使用Google Translate机器翻译而来。
该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里. |
| 在头文件 <stdlib.h> 中定义
|
||
| int wctomb( char* s, wchar_t wc ); |
||
一个宽字符转换成
wc多字节编码，并将其存储（包括任何移位序列）中的char数组，该数组的第一个元素是指向s。不超过MB_CUR_MAX字符存储.原文：
Converts a wide character
wc to multibyte encoding and stores it (including any shift sequences) in the char array whose first element is pointed to by s. No more than MB_CUR_MAX characters are stored.wc是空字符，空字节写入s，在此之前的任何必要的移位序列的，恢复初始位移状态.原文：
If
wc is the null character, the null byte is written to s, preceded by any shift sequences necessary to restore the initial shift state.如果
s是一个空指针，将全局转换状态，并确定是否使用了移位序列.原文：
If
s is a null pointer, resets the global conversion state and determines whether shift sequences are used.目录 |
[编辑] 注释
每次调用
wctomb更新的内部全局转换状态（静态mbstate_t类型的对象，只知道此功能）。如果多字节编码使用上档状态，这个函数是不可重入的。在任何情况下，多线程不应该叫wctomb不同步：wcrtomb可以用来代替.原文：
Each call to
wctomb updates the internal global conversion state (a static object of type mbstate_t, only known to this function). If the multibyte encoding uses shift states, this function is not reentrant. In any case, multiple threads should not call wctomb without synchronization: wcrtomb may be used instead.[编辑] 参数
| s | - | 用于输出的字符数组的指针
原文： pointer to the character array for output |
| wc | - | 宽字符转换
|
[编辑] 返回值
如果
s是不是一个空指针，返回的字节数中所包含的多字节表示，如果wc或-1wc是不是一个有效的字符. 原文：
If
s is not a null pointer, returns the number of bytes that are contained in the multibyte representation of wc or -1 if wc is not a valid character. 如果
s是一个空指针，将其内部的转换状态来表示的初始变速状态，并返回0如果当前的多字节编码不是状态依赖（不使用移位序列）或一个非零的值，如果当前的多字节编码是状态依赖（使用Shift序列）.原文：
If
s is a null pointer, resets its internal conversion state to represent the initial shift state and returns 0 if the current multibyte encoding is not state-dependent (does not use shift sequences) or a non-zero value if the current multibyte encoding is state-dependent (uses shift sequences).[编辑] 示例
| 本章尚未完成 原因：暂无示例 |
[编辑] 另请参阅
| 未来的多字节字符转换为宽字符 原文： converts the next multibyte character to wide character （函数） | |
| 一个宽字符转换为多字节表示，给定的状态 原文： converts a wide character to its multibyte representation, given state （函数） | |
| C++ documentation for wctomb
| |
