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

戻り値

1つの InternT 文字を生成するために in() で変換された場合に消費される可能性がある ExternT 文字の最大数。

変換を行わない特殊化 std:: codecvt < char , char , std:: mbstate_t > は 1 を返します。

注記

エンコーディングが状態依存の場合（ encoding ( ) == - 1 ）、1つの内部文字を生成するために max_length() 以上の外部文字が消費される可能性があります。

例

#include <codecvt>
#include <iostream>
#include <locale>
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

関連項目