std:: num_get
|
定义于头文件
<locale>
|
||
|
template
<
class
CharT,
|
||
类
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 来解析数字的文本表示形式。
继承关系图
如果标准库不保证提供某个
std::num_get
特化(参见下文),其
get()
和
do_get()
成员函数的行为不保证符合规范说明。
目录 |
特化
标准库保证提供以下特化(它们 是任何locale对象都必须实现的 ):
|
定义于头文件
<locale>
|
|
| std :: num_get < char > | 创建窄字符串数字解析 |
| std :: num_get < wchar_t > | 创建宽字符串数字解析 |
此外,标准库还保证提供满足以下类型要求的每个特化:
-
CharT是以下类型之一:- char ,
- wchar_t ,以及
- 任何其他实现定义的 字符容器类型 ,需满足可在其上实例化任意 iostream组件 的字符要求;且
-
InputIt必须满足 LegacyInputIterator 的要求。
嵌套类型
| 类型 | 定义 |
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>
的公开成员函数)
|