Namespaces
Variants

std:: num_get

From cppreference.net
定义于头文件 <locale>
template <

class CharT,
class InputIt = std:: istreambuf_iterator < CharT >

> class num_get ;

std::num_get 封装了解析数值字符串表示的规则。具体支持的类型包括 bool unsigned short unsigned int long unsigned long long long unsigned long long (C++11 起) float double long double 以及 void * 。标准格式化输入运算符(例如 cin >> n ; )使用 I/O 流区域设置的 std::num_get facet 来解析数字的文本表示形式。

cpp/locale/locale/facet std-num get-inheritance.svg

继承关系图

如果标准库不保证提供某个 std::num_get 特化(参见下文),其 get() do_get() 成员函数的行为不保证符合规范说明。

目录

特化

标准库保证提供以下特化(它们 是任何locale对象都必须实现的 ):

定义于头文件 <locale>
std :: num_get < char > 创建窄字符串数字解析
std :: num_get < wchar_t > 创建宽字符串数字解析

此外,标准库还保证提供满足以下类型要求的每个特化:

嵌套类型

类型 定义
char_type CharT
iter_type InputIt

数据成员

成员 描述
std::locale::id id [static] facet 的标识符

成员函数

构造新的 num_get facet
(公开成员函数)
调用 do_get
(公开成员函数)

受保护成员函数

析构 num_get facet
(受保护成员函数)
[virtual]
从输入流解析数字
(虚受保护成员函数)

示例

#include <iostream>
#include <iterator>
#include <locale>
#include <sstream>
#include <string>
int main()
{
    std::string de_double = "1.234.567,89";
    std::string us_double = "1,234,567.89";
    // 使用流进行解析
    std::istringstream de_in(de_double);
    de_in.imbue(std::locale("de_DE.UTF-8"));
    double f1;
    de_in >> f1;
    std::istringstream us_in(de_double);
    us_in.imbue(std::locale("en_US.UTF-8"));
    double f2;
    us_in >> f2;
    std::cout << "解析 " << de_double << " 作为 double 类型,在 de_DE 区域设置下得到 " << std::fixed
              << f1 << ",在 en_US 区域设置下得到 " << f2 << "\n";
    // 直接使用 facet
    std::istringstream s3(us_double);
    s3.imbue(std::locale("en_US.UTF-8"));
    auto& f = std::use_facet<std::num_get<char>>(s3.getloc());
    std::istreambuf_iterator<char> beg(s3), end;
    double f3;
    std::ios::iostate err;
    f.get(beg, end, s3, err, f3);
    std::cout << "使用原始 en_US facet 将 " << us_double
              << " 解析为 double 类型得到 " << f3 << '\n';
}

输出:

解析 1.234.567,89 作为 double 类型,在 de_DE 区域设置下得到 1234567.890000,在 en_US 区域设置下得到 1.234000
使用原始 en_US facet 将 1,234,567.89 解析为 double 类型得到 1234567.890000

缺陷报告

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

缺陷报告 适用范围 发布时行为 正确行为
LWG 427 C++98 num_get 被保证接受任何满足
iostream组件可实例化的字符
类型要求的 CharT
仅保证接受 char
wchar_t 及其他实现
定义的字符类型
LWG 2392 C++98 仅字符类型 CharT 可被
保证被 num_get 接受
可保证接受实现定义
的字符容器类型

参见

定义数值标点规则
(类模板)
将数值格式化为字符序列输出
(类模板)
提取格式化数据
( std::basic_istream<CharT,Traits> 的公开成员函数)