std::codecvt<InternT,ExternT,StateT>::max_length, do_max_length
来自cppreference.com
| 在标头 <locale> 定义
|
||
| (1) | ||
| public: int max_length() const throw(); |
(C++11 前) | |
| public: int max_length() const noexcept; |
(C++11 起) | |
| (2) | ||
| protected: virtual int do_max_length() const throw(); |
(C++11 前) | |
| protected: virtual int do_max_length() const noexcept; |
(C++11 起) | |
1) 公开成员函数，调用最终派生类的成员函数
do_max_length 。2) 返回对于任何合法范围
[from, from_end) 和任何 state 合法 ， do_length(state, from, from_end, 1) 所能返回的最大值。返回值
若以 in() 转换生成一个 InternT 字符，能消耗的最大 ExternT 字符数。
不转换特化 std::codecvt<char, char, std::mbstate_t> 返回 1 。
注意
若编码依赖状态（ encoding() == -1 ），则可能消耗多于 max_length() 个外部字符生成一个内部字符。
示例
运行此代码
#include <locale> #include <iostream> #include <codecvt> int main() { std::cout << "In codecvt_utf8, the longest multibyte character is " << std::codecvt_utf8<wchar_t>().max_length() << " bytes long\n"; std::cout << "In header-consuming codecvt_utf8, the longest multibyte character is " << std::codecvt_utf8<wchar_t, 0x10ffff, std::consume_header>().max_length() << " bytes long\n"; std::cout << "In this system's en_US.utf8, the longest multibyte character is " << std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>( std::locale("en_US.utf8") ).max_length() << " bytes long\n"; std::cout << "In this system's zh_CN.gb18030, the longest multibyte character is " << std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>( std::locale("zh_CN.gb18030") ).max_length() << " bytes long\n"; }
输出：
In codecvt_utf8, the longest multibyte character is 4 bytes long In header-consuming codecvt_utf8, the longest multibyte character is 7 bytes long In this system's en_US.utf8, the longest multibyte character is 6 bytes long In this system's zh_CN.gb18030, the longest multibyte character is 4 bytes long
参阅
| MB_CUR_MAX |
当前 C 本地环境中多字节字符的最大字节数 (宏变量) |
| [虚] |
返回产生一个 InternT 字符所需的 ExternT 字符数，如果它是常数 (虚受保护成员函数) |