close

std::codecvt<InternT,ExternT,StateT>::max_length, do_max_length

来自cppreference.com
 
C++
 
文本处理库
 
本地化库
 
std::codecvt
 
在标头 <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 字符数，如果它是常数
(虚受保护成员函数) [编辑]