std::mblen
来自cppreference.com
 |
该页由英文版wiki使用Google Translate机器翻译而来。
该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里. |
| 在头文件 <cstdlib> 中定义
|
||
| int mblen( const char* s, std::size_t n ); |
||
。
确定文件的大小，以字节为单位的多字节字符的第一个字节指出，
s. 原文：
Determines the size, in bytes, of the multibyte character whose first byte is pointed to by
s. 。如果
s是一个空指针，将全局转换状态，并确定是否使用了移位序列.原文：
If
s is a null pointer, resets the global conversion state and determined whether shift sequences are used.。此功能是相当于呼叫std::mbtowc((wchar_t*)0, s, n)，不同的转换状态std::mbtowc不受影响.
原文：
This function is equivalent to the call std::mbtowc((wchar_t*)0, s, n), except that conversion state of std::mbtowc is unaffected.
目录 |
[编辑] 。注释。
。每次调用
mblen更新的内部全局转换状态（静态std::mbstate_t类型的对象，只知道此功能）。如果多字节编码使用上档状态，必须小心，以避免回溯或多次扫描。在任何情况下，多线程不应该叫mblen不同步：std::mbrlen可以用来代替.原文：
Each call to
mblen updates the internal global conversion state (a static object of type std::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 mblen without synchronization: std::mbrlen may be used instead.[编辑] 。参数。
| 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).[编辑] 。为例。
#include <clocale> #include <string> #include <iostream> #include <cstdlib> #include <stdexcept> // the number of characters in a multibyte string is the sum of mblen()'s // note: the simpler approach is std::mbstowcs(NULL, s.c_str(), s.size()) std::size_t strlen_mb(const std::string& s) { std::size_t result = 0; const char* ptr = &s[0]; const char* end = ptr + s.size(); std::mblen(NULL, 0); // reset the conversion state while (ptr < end) { int next = std::mblen(ptr, end-ptr); if (next == -1) { throw std::runtime_error("strlen_mb(): conversion error"); } ptr += next; ++result; } return result; } int main() { // allow mblen() to work with UTF-8 multibyte encoding std::setlocale(LC_ALL, "en_US.utf8"); // UTF-8 narrow multibyte encoding std::string str = u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋" // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b"; std::cout << str << " is " << str.size() << " bytes, but only " << strlen_mb(str) << " characters\n"; }
输出：
zß水𝄋 is 10 bytes, but only 4 characters
[编辑] 。另请参阅。
| 未来的多字节字符转换为宽字符 原文： converts the next multibyte character to wide character （函数） | |
| 在给定的状态下的多字节字符，返回的字节数 原文： returns the number of bytes in the next multibyte character, given state （函数） | |
| C documentation for mblen
| |
