std::money_get<CharT,InputIt>::get, do_get
| 定义于头文件 <locale> |
||
| public: iter_type get( iter_type beg, iter_type end, bool intl, std::ios_base& str, |
(1) | |
| iter_type get( iter_type beg, iter_type end, bool intl, std::ios_base& str, std::ios_base::iostate& err, string_type& digits ) const; |
(2) | |
| protected: virtual iter_type do_get( iter_type beg, iter_type end, bool intl, std::ios_base& str, |
(3) | |
| virtual iter_type do_get( iter_type beg, iter_type end, bool intl, std::ios_base& str, std::ios_base::iostate& err, string_type& digits ) const; |
(4) | |
从输入迭代器解析货币值，并将结果写入 long double 或字符串。
do_get。ct），std::moneypunct<CharT, intl> facet（本页余下部分称为 mp），以及从 str.flags() 获取的流格式化标志指定的规则格式化的货币值。如果在解析完成之前输入迭代器 beg 等于 end，则在 err 中设置 failbit 和 eofbit。如果由于其他原因解析失败，则在 err 中设置 failbit。无论哪种方式，都不会在错误时修改输出参数（units 或 digits）。
如果解析成功，则不更改 err，并将结果存储在 units 或 digits 中。
此函数使用的格式化 模式 始终为 mp.neg_format()。
如果 mp.grouping() 不允许千位分隔符，则遇到的第一个分隔符被视为解析错误，否则它们被视为可选。
如果 money_base::space 或 money_base::none 是 模式 中的最后一个元素，则在解析货币值的其他组成部分后，解析器不会尝试消耗任何空格。 否则，当出现 money_base::space 时，会消耗一个或多个空格字符。
如果在 str.flags() 中设置了 showbase 标志，则需要货币符号或货币字符串；如果未设置，则货币符号是可选的。
如果在格式化模式的 money_base::sign 位置找到 mp.positive_sign() 或 mp.negative_sign() 返回的字符串的第一个字符，则会消耗它，并且在货币值的所有其他组成部分之后，预期并消耗该字符串的其余字符。如果 mp.positive_sign() 和 mp.negative_sign() 均为非空，则符号是必需的，并且必须与这些字符串之一的第一个字符匹配。如果其中一个字符串为空，则符号是可选的（如果它不存在，则结果的符号对应于空字符串）。如果两个字符串都为空，或者具有相同的第一个字符，则结果被赋予正号。如果输出参数是字符串 (digits) 并且结果为负数，则值 ct.widen('-') 将存储为结果的第一个字符。
从输入中提取的数字按照它们出现的顺序放置在 digits 中（在通过 ct.widen() 加宽后），或放入临时缓冲区 buf1 中，从中构造 units 的值，就像通过
static const char src[] = "0123456789-"; CharT atoms[sizeof(src)]; ct.widen(src, src + sizeof(src) - 1, atoms); for (int i = 0; i < n; ++i) buf2[i] = src[find(atoms, atoms+sizeof(src), buf1[i]) - atoms]; buf2[n] = 0; sscanf(buf2, "%Lf", &units);
（其中 n 是从输入中提取并存储在 buf1 中的字符数，而 buf2 是另一个足够大的字符缓冲区）。
目录 |
[编辑] 返回值
一个迭代器，指向紧跟在被识别为货币字符串输入的有效部分的最后一个字符之后的位置。
[编辑] 注释
货币单位被假定为货币的最小非分数单位：美国的 cents，日本的 yen。因此，在美国区域设置中，输入序列 "$1,056.23" 会在 units 中生成数字 105623.0，或者在 digits 中生成字符串 "105623"。
由于如果 showbase 关闭，货币符号是可选的，但整个多字符 negative_sign() 是必需的，给定格式化模式 {sign, value, space, symbol}，其中 showbase 关闭，且 negative_sign 为 "-"，字符串 "-1.23 €" 解析为 -123，并在输入流中留下 "€" 未消耗，但如果 negative_sign 为 "()"，则字符串 "(1.23 €)" 将完全消耗。
I/O 操纵符 std::get_money 为此函数提供了更简单的接口。
[编辑] 示例
#include <iostream> #include <locale> #include <sstream> void demo_money_get(std::locale loc, const std::string& input) { std::istringstream str(input); str.imbue(loc); long double units; // The following can be written simpler with std::get_money(units) std::ios_base::iostate err = std::ios_base::goodbit; std::istreambuf_iterator<char> ret = std::use_facet<std::money_get<char>>(loc).get( std::istreambuf_iterator<char>(str), std::istreambuf_iterator<char>(), false, str, err, units); str.setstate(err); std::istreambuf_iterator<char> last{}; if (str) { std::cout << "Successfully parsed '" << str.str() << "' as " << units / 100 << " units\n"; if (ret != last) { std::cout << "Remaining content: '"; std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout)); std::cout << "'\n"; } else std::cout << "The input was fully consumed\n"; } else { std::cout << "Parse failed. Unparsed string: '"; std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout)); std::cout << "'\n"; } } int main() { demo_money_get(std::locale("en_US.utf8"), "-$5.12 abc"); demo_money_get(std::locale("ms_MY.utf8"), "(RM5.12) def"); }
输出
Successfully parsed '-$5.12 abc' as -5.12 units Remaining content: ' abc' Successfully parsed '(RM5.12) def' as -5.12 units Remaining content: ' def'
[编辑] 参见
| 定义 std::money_get 和 std::money_put 使用的货币格式化参数 (类模板) | |
| 从输入字符序列解析和构造货币值 (类模板) | |
| (C++11) |
解析货币值 (函数模板) |
