转换在三个阶段出现

阶段 1 ：转换说明符选择

• 获得 I/O 格式化标志，如同以

fmtflags basefield = (str.flags() & std::ios_base::basefield);

fmtflags boolalpha = (str.flags() & std::ios_base::boolalpha);

• 若 v 的类型为整数类型，则选择下列五个选项的首个可应用者：

若 basefield == oct ，则将使用转换说明符 %o

若 basefield == hex ，则将使用转换说明符 %X

若 basefield == 0 ，则将使用转换说明符 %i

若 v 的类型有符号，则将使用转换说明符 %d

若 v 的类型无符号，则将使用转换说明符 %u

• 对于整数类型，若需要则添加长度说明符到转换说明：对于 short 和 unsigned short 为 h ，对于 long 和 unsigned long 为 l ，对于 long long 和 unsigned long long 为 ll
• 若 v 的类型为 float ，则将使用转换说明符 %g
• 若 v 的类型为 double ，则将使用转换说明符 %lg
• 若 v 的类型为 long double ，则将使用转换说明符 %Lg
• 若 v 的类型为 void* ，则将使用转换说明符 %p
• 若 v 的类型为 bool 且 boolalpha==0 ，则如同按 v 的类型为 long 一般处理，除了在阶段 3 存储于 v 的值。
• 若 v 的类型为 bool 且 boolalpha!=0 ，则下列规则替换阶段 2 和 3 ：
  • 从输入迭代器 in 获得匹配获得自 std::use_facet<std::numpunct<charT>>(str.getloc()).falsename() 和 std::use_facet<std::numpunct<charT> >(str.getloc()).truename() 的相继字符，而且仅按需要匹配鉴别唯一匹配。仅在需要获得字符时，将输入迭代器 in 与 end 比较。
  • 若目标序列为唯一匹配，则设置 v 为对应的 bool 值。否则存储 false 于 v 并赋值 std::ios_base::failbit 给 err 。若在输入结束（ in==end ）前无法找到唯一匹配，则执行 err|=std::ios_base::eofbit 。

阶段 2 ：字符释出

• 若 in==end ，则立即终止阶段 2 ，则不再释出更多字符
• 如同以 char_type ct = *in; 从 in 释出下个字符
  • 若字符匹配如同用 std::use_facet<std::ctype<charT>>(str.getloc()).widen() 加宽到 locale 的 char_type 的 "0123456789abcdefxABCDEFX+-" 字符之一，则将它转换为对应的 char 。
  • 若字符匹配小数点（ std::use_facet<std::numpunct<charT>>(str.getloc()).decimal_point()) ），则以 '.' 替换之。
  • 若字符匹配千分隔符（ std::use_facet<std::numpunct<charT>>(str.getloc()).thousands_sep() ）且在所有 std::use_facet<std::numpunct<charT>>(str.getloc()).grouping().length() != 0 中使用千分隔，则若尚未积累小数点 '.' ，则记忆该字符的位置，但其他情况下忽略该字符。若已基类小数点，则舍弃该字符并终止阶段 2 。
  • 任何情况下，检查从前一步骤获得的 char 是否在会为 std::scanf 给定阶段 1 中选择的转换指定符的输入域中得到允许。若它受允许，则将它积累到临时缓冲区并重复阶段 2 。若它不受允许，则阶段 2 终止。

阶段 3 ：转换与存储

• 转换阶段 2 中积累的 char 序列为数值

• 任何情况下，若转换函数失败，则赋值 std::ios_base::failbit 为 err
• 否则，存储转换的数值结果于 v
  • 若 v 的类型为 bool 且未设置 boolalpha ，则若要存储的值为 ​0​ 则存储 false ，若要存储的值为 1 则存储 true ，对于任何其他值，赋值 std::ios_base::failbit 为 err 并存储 true 。
• 之后，检查数位分组。若阶段 2 中舍弃的任何千分隔符的位置不匹配 std::use_facet<std::numpunct<charT>>(str.getloc()).grouping() 所提供的分组，则赋值 std::ios_base::failbit 为 err 。
• 若因测试 in==end 终止阶段 2 ，则执行 err|=std::ios_base::eofbit 设置 eof 位。

返回值

in

注解

C++98/C++03 中，若出现错误，则保留 v 不更改。 C++11 中，它被设为上述的值。

转换负整数字符串为无符号整数时，某些实现产生零（因为字符串所表示的值小于目标类型所能表示的）。这种行为曾被 C++11/14 标准指定，但被 LWG #1169 更正。

因为阶段 2 滤出如 'p' 、 'N' 或 'i' 的字符，如 "0x1.23p-10" 的十六进制浮点数和字符串 "NaN" 或 "inf" 可能为 do_get(double) 所拒绝，即使它们它们是对 strtod 的合法输入：此为 LWG #2381 。

示例

#include <iostream>
#include <iterator>
#include <locale>
 
struct base { long x; };
 
template <class CharT, class Traits>
std::basic_istream<CharT, Traits>&
    operator >>(std::basic_istream<CharT, Traits>& is,
                base& b)
{
    std::ios_base::iostate err = std::ios_base::goodbit;
    try // 设置 err 为能抛出
    {
        typename std::basic_istream<CharT, Traits>::sentry s(is);
 
        if (s) // 若流已为输入就绪
        {
            std::use_facet<std::num_get<CharT>>(is.getloc()).get(is, {}, is, err, b.x);
        }
    } catch(std::ios_base::failure& error)
    {
        // 处理异常
    }
    return is;
}
 
int main()
{
    base b;
 
    std::cin >> b;
}

参阅