num_get：C++里那个默默拆解数字的“老技工”

你有没有试过用 std::cin >> x 读一个整数，结果输入了 "123abc"，程序却只取走 123，还让后续读取卡在 'a' 上？或者更糟——输入 "0x1F" 却被当成 0？这时候，你其实在和 std::num_get 打交道，只是它藏得太深，连 operator>> 都只是它的前台代理。

num_get 不是语法糖，也不是工具函数，它是 C++ 标准库中真正执行数字解析逻辑的底层设施。它不关心你是用 cin 还是自己构造的 basic_istream，也不管 locale 是简体中文还是德语——它只做一件事：从字符序列里，按当前 facet 规则，切出尽可能长的有效数字前缀，并转成对应类型值。

这听起来像 strtol 或 std::from_chars？不完全是。num_get 的特别之处在于：它把“解析动作”和“流状态管理”绑在一起。比如遇到非法字符，它不会抛异常（默认不抛），而是设置 failbit，并把输入位置停在第一个无法解析的字符上——这个行为，正是 cin >> n 能“半截读取”又不崩的原因。

举个实在的例子：

#include <sstream>
#include <locale>
#include <iostream>

int main() {
    std::istringstream iss("  +42.5e-1xyz");
    iss.imbue(std::locale::classic()); // 确保用 C locale

    long val = 0;
    auto& ng = std::use_facet<std::num_get<char>>(iss.getloc());
    std::ios_base::iostate state = std::ios_base::goodbit;

    // 注意：这里传入的是 istream 的迭代器对，不是字符串
    auto it = ng.get(iss, std::istreambuf_iterator<char>(iss),
                     std::istreambuf_iterator<char>(),
                     iss, state, val);

    std::cout << "parsed: " << val << ", state: " << state << '\n';
    // 输出：parsed: 4, state: 4 (failbit) —— 因为它只认整数，遇到 '.' 就停
}

看到没？val 是 4，不是 42，更不是 425。num_get::get 对 long 类型只解析整数部分，遇到 '.' 立刻收手，state 被设为 failbit，而 it 指向 '.'。它不猜测，不补全，不宽容——只严格按类型契约办事。

这也是为什么 cin >> double 能读 "3.14"，但 cin >> int 遇到 "3.14" 却只吞掉 3：背后调用的是不同特化版本的 num_get::get，它们对“什么是合法前缀”的定义完全不同。

再往细处想一层：num_get 的解析规则，其实由 locale 的 numeric facet 控制。比如德语 locale 中，小数点是逗号：

std::locale de("de_DE.UTF-8");
std::istringstream iss("123,45");
iss.imbue(de);
double d;
iss >> d; // 这时能正确读出 123.45

这背后，num_get 查的是 de 的 decimal_point()，而不是硬编码 '.'。你换 locale，它就自动切规则——不用改一行业务代码。 这种解耦，正是标准库设计的精妙处：把“怎么读”交给 facet，把“读什么”交给用户。

那什么时候该绕过 operator>>，直接调 num_get？
当你需要精确控制解析起点、终点，或想复用解析逻辑但不绑定流状态时。
比如写一个配置解析器，一行里混着数字和标识符："timeout=3000ms retry=3"。你不想用 >> 把整个流搅乱，就可以手动构造 istreambuf_iterator，对子串调 num_get::get，失败了也不影响流的 failbit。

还有一个常被忽略的细节：num_get::get 不跳过前导空白。operator>> 会先调 std::ws，但 num_get 不会。这意味着：如果你传入 " 42" 的迭代器对，它会立刻在空格处失败（除非你显式跳过）。这点必须手控，否则容易踩坑。

最后说句实在话：num_get 不是日常开发的首选工具。95% 的场景，>> 或 std::from_chars 更直白、更快、更安全。但当你调试一个“读一半就卡住”的输入逻辑，或者需要跨 locale 稳定解析，或者在写底层 IO 库时——它就是那个你翻手册翻到凌晨两点，终于看懂后拍大腿说“原来如此”的关键拼图。

它不 flashy，不 trendy，甚至文档都写得干巴巴。但它稳，它准，它把“字符变数字”这件事，拆解得清清楚楚，毫无歧义。就像老师傅修钟表，不说话，但每个齿轮咬合的位置，都差不了半丝。

下次 cin 又悄悄吃掉你输入里的半个数字时，别急着骂——掀开盖子看看，那个沉默的 num_get，正蹲在底层，一丝不苟地划下解析的截止线。