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 <codecvt> #include <iostream> #include <locale> int main() { std::cout << "在 codecvt_utf8 中，最长多字节字符为 " << std::codecvt_utf8<wchar_t>().max_length() << " 字节\n"; std::cout << "在消耗头部的 codecvt_utf8 中，最长多字节字符为 " << std::codecvt_utf8<wchar_t, 0x10ffff, std::consume_header>().max_length() << " 字节\n"; std::cout << "在本系统的 en_US.utf8 中，最长多字节字符为 " << std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>( std::locale("en_US.utf8") ).max_length() << " 字节\n"; std::cout << "在本系统的 zh_CN.gb18030 中，最长多字节字符为 " << std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>( std::locale("zh_CN.gb18030") ).max_length() << " 字节\n"; }
输出：
在 codecvt_utf8 中，最长多字节字符为 4 字节 在消耗头部的 codecvt_utf8 中，最长多字节字符为 7 字节 在本系统的 en_US.utf8 中，最长多字节字符为 6 字节 在本系统的 zh_CN.gb18030 中，最长多字节字符为 4 字节
参阅
| MB_CUR_MAX |
当前 C 本地环境中多字节字符的最大字节数 (宏变量) |
| [虚] |
返回产生一个 InternT 字符所需的 ExternT 字符数，如果它是常数 (虚受保护成员函数) |