std::codecvt<InternT,ExternT,StateT>:: in, std::codecvt<InternT,ExternT,StateT>:: do_in

如果此 codecvt facet 未定义转换，则不会转换任何字符。 to_next 将被设置为等于 to ， state 保持不变，并返回 std::codecvt_base::noconv 。

do_in ( state, from, from_end, from_next, to, to + 1 , to_next ) 必须返回 ok 如果

• 此 codecvt 转换刻面被 basic_filebuf 所使用，且
• do_in ( state, from, from_end, from_next, to, to_end, to_next ) 将返回 ok 当 to ! = to_end 时。

返回值

类型为 std::codecvt_base::result 的值，用于指示成功状态如下：

不进行转换的特化 std:: codecvt < char , char , std:: mbstate_t > 始终返回 std::codecvt_base::noconv 。

注释

要求满足 from <= from_end && to <= to_end ，且 state 要么表示初始移位状态，要么通过转换序列中前序字符获得。

对 state 的影响是刻意未指定的。在标准 facet 中，它用于维护移位状态（如同调用 std::mbsrtowcs 时），因此会被更新以反映最后一个已处理外部字符后的转换状态，但用户定义的 facet 可以自由使用它来维护任何其他状态，例如统计遇到的特殊字符数量。

示例

#include <iostream>
#include <locale>
#include <string>
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    auto const& f = std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>
        (std::locale());
    std::string external = "z\u00df\u6c34\U0001d10b"; // 或 u8"zß水𝄋"
                     // 或 "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b"
    // 注意以下操作也可通过 wstring_convert 实现
    std::mbstate_t mb = std::mbstate_t(); // 初始移位状态
    std::wstring internal(external.size(), '\0'); 
    const char* from_next;
    wchar_t* to_next;
    f.in(mb, &external[0], &external[external.size()], from_next,
             &internal[0], &internal[internal.size()], to_next);
    // 为简洁起见省略了错误检查
    internal.resize(to_next - &internal[0]);
    std::wcout << L"The string in wide encoding: " << internal << '\n';
}

The string in wide encoding: zß水𝄋

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见