mbtowc
来自cppreference.com
 |
该页由英文版wiki使用Google Translate机器翻译而来。
该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里. |
| 在头文件 <stdlib.h> 中定义
|
||
| int mbtowc( wchar_t* pwc, const char* s, size_t n ) |
||
转换一个多字节字符的第一个字节指出，
s为宽字符，写入*pwcpwc不为空.原文：
Converts a multibyte character whose first byte is pointed to by
s to a wide character, written to *pwc if pwc is not null.如果
s是一个空指针，将全局转换状态，并确定是否使用了移位序列.原文：
If
s is a null pointer, resets the global conversion state and determines whether shift sequences are used.目录 |
[编辑] 注释
每次调用
mbtowc更新的内部全局转换状态（静态mbstate_t类型的对象，只知道此功能）。如果多字节编码使用上档状态，必须小心，以避免回溯或多次扫描。在任何情况下，多线程不应该叫mbtowc不同步：mbrtowc可以用来代替.原文：
Each call to
mbtowc 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, care must be taken to avoid backtracking or multiple scans. In any case, multiple threads should not call mbtowc without synchronization: mbrtowc may be used instead.[编辑] 参数
| pwc | - | 用于输出的宽字符指针
原文： pointer to the wide character for output |
| s | - | 多字节字符的指针
|
| n | - | 限制的字节数，可以检查
原文： limit on the number of bytes in s that can be examined |
[编辑] 返回值
如果
s是不是一个空指针，返回的字节数中所包含的多字节字符或-1如果第一个字节所指向的s没有形成一个有效的多字节字符或0如果s指向空字符内'\0'，.原文：
If
s is not a null pointer, returns the number of bytes that are contained in the multibyte character or -1 if the first bytes pointed to by s do not form a valid multibyte character or 0 if s is pointing at the null charcter '\0'.如果
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, given state （函数） | |
| 在未来的多字节字符，返回的字节数 原文： returns the number of bytes in the next multibyte character （函数） | |
| C++ documentation for mbtowc
| |
