std::codecvt<InternT,ExternT,StateT>::length, do_length
来自 cppreference.com
| 定义在头文件 <locale> 中 |
||
| public: int length( StateT& state, const ExternT* from, const ExternT* from_end, |
(1) | |
| protected: virtual int do_length( StateT& state, const ExternT* from, const ExternT* from_end, |
(2) | |
1) 公共成员函数，调用最派生类的成员函数
do_length。2) 尝试将由
[from, from_end) 定义的字符数组中的 ExternT 字符，在给定初始转换状态 state 的情况下，转换为最多 max 个 InternT 字符，并返回此类转换将使用的 ExternT 字符数。修改 state，就像执行 do_in(state, from, from_end, from, to, to + max, to) 一样，对于一些虚构的 [to, to + max) 输出缓冲区。内容 |
[编辑] 返回值
如果通过 do_in() 转换，直到所有 from_end - from 字符都被使用，或者产生 max 个 InternT 字符，或者发生转换错误，则将使用的 ExternT 字符数。
非转换特化 std::codecvt<char, char, std::mbstate_t> 返回 std::min(max, from_end - from).
[编辑] 示例
运行此代码
#include <iostream> #include <locale> #include <string> int main() { using facet_type = std::codecvt<wchar_t, char, std::mbstate_t>; // narrow multibyte encoding std::string s = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋" // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b" std::locale loc("en_US.UTF-8"); facet_type const& codecvt_facet = std::use_facet<facet_type>(loc); std::mbstate_t mb = std::mbstate_t(); std::cout << "Only the first " << codecvt_facet.length(mb, s.data(), s.data() + s.size(), 2) << " bytes out of " << s.size() << " would be consumed" " to produce the first 2 characters\n"; }
输出
Only the first 3 bytes out of 10 would be consumed to produce the first 2 characters
[编辑] 缺陷报告
以下行为改变的缺陷报告被追溯地应用于之前发布的 C++ 标准。
| DR | 应用于 | 已发布的行为 | 正确行为 |
|---|---|---|---|
| LWG 75 | C++98 | 对 state 的影响没有指定 | 已指定 |
| LWG 305 | C++98 | std::codecvt<wchar_t, char, std::mbstate_t>::do_length要求返回 std::min(max, from_end - from) |
不要求 |
[编辑] 另请参见
| [虚拟] |
将字符串从 ExternT 转换为 InternT，例如从文件读取时(虚拟受保护成员函数) |
