std::codecvt<InternT,ExternT,StateT>::max_length, do_max_length
来自cppreference.com
本地化库
本地环境与平面 | |||||||||||||||||||||
本地环境 | |||||||||||||||||||||
平面类别基类 | |||||||||||||||||||||
ctype(字符类别)平面 | |||||||||||||||||||||
numeric(数值)平面 | |||||||||||||||||||||
collate(对照比较)平面 | |||||||||||||||||||||
time(时间)平面 | |||||||||||||||||||||
monetary(货币)平面 | |||||||||||||||||||||
messages(消息)平面 | |||||||||||||||||||||
字符分类与转换 | |||||||||||||||||||||
字符分类 | |||||||||||||||||||||
转换 | |||||||||||||||||||||
|
|||||||||||||||||||||
编码转换平面 | |||||||||||||||||||||
|
|
||||||||||||||||||||
C 本地环境 | |||||||||||||||||||||
在标头
<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 字符数,如果它是常数 (虚受保护成员函数) |