c++11 标准模板（STL）本地化库 - 平面类别（std::money_get） - 从输入字符序列中解析并构造货币值

本地化库

本地环境设施包含字符分类和字符串校对、数值、货币及日期/时间格式化和分析，以及消息取得的国际化支持。本地环境设置控制流 I/O 、正则表达式库和 C++ 标准库的其他组件的行为。

平面类别

从输入字符序列中解析并构造货币值

std::money_get

类模板 std::money_get 封装从字符流剖析货币值的规则。标准 I/O 操纵符 std::get_money 使用 I/O 流的 locale 的 std::money_get 平面。

继承图

类型要求

特化

标准库提供二个孤立（独立于本地环境）的全特化和二个部分特化：

另外， C++ 程序中构造的每个 locale 对象都实装这些特化的其自身（本地环境限定）版本。

成员类型

成员函数

受保护成员函数

成员对象

构造新的 money_get 平面

std::money_get<CharT,InputIt>::money_get

创建 std::money_get 平面并转发引用计数 refs 到基类构造函数 locale::facet::facet() 。

参数

销毁 money_get 平面

std::money_get<CharT,InputIt>::~money_get

析构 std::money_get 平面。此析构函数为受保护且为虚（由于基类析构函数为虚）。 std::money_get 类型对象，同大多数平面，只能在最后一个实装此平面的 std::locale 离开作用域时，或若用户定义导出自 std::money_get 并实现公开构造函数，才会被销毁。

调用示例

#include <iostream>
#include <locale>

struct Destructible_money_get : public std::money_get<wchar_t>
{
    Destructible_money_get(std::size_t refs = 0) : money_get(refs) {}
    // 注意：隐式析构函数为公开
};

int main()
{
    Destructible_money_get dc;
    // std::money_get<wchar_t> c;  // 编译错误：受保护析构函数
    return 0;
}

分析来自输入流的货币值

std::money_get<CharT,InputIt>::get, do_get

剖析来自输入迭代器的货币值，并写结果到 long double 或 string 。

1-2) 公开成员函数，调用最终导出类的成员函数 do_get 。

3-4) 从输入迭代器 beg 读取字符，期待找到按照 str.getloc() 中感染的 std::ctype 平面（下称 ct ）、 str.getloc() 中感染的 std::moneypunct<CharT, intl> 平面（下称 mp ）及获得自 str.flags() 的流格式化标志所指定的规则格式化的货币值。

若输入迭代器 beg 在分析完成前变得等于 end ，则在 err 中一同设置 failbit 和 eofbit 。若分析因另一原因失败，则在 err 中设置 failbit 。无论如何，都不在错误时修改输出参数（ units 或 digits ）。

若分析成功，则不更改 err ，并存储结果于 units 或 digits 。

此函数所用的格式化 pattern 始终为 mp.neg_format() 。

若 mp.grouping() 不容许千分隔符，则将首个遇到的分隔符当做错误，否则将它们当做可选的。

若 money_base::space 或 money_base::none 是 pattern 中的最后元素，则分析器不尝试在分析货币值的其他组分后消耗任何空白符。否则在 money_base::space 出现处消耗一或多个空白字符。

若 str.flags() 中设置了 showbase 标志，则要求通货符号或通货字符串，若未设置，则通货符号可选。

若在格式化模式的 money_base::sign 位置找到 mp.positive_sign() 或 mp.negative_sign() 所返回的字符串的首字符，则消耗之，而在货币值的所有其他组分后期待并消耗剩余字符。若 mp.positive_sign() 与 mp.negative_sign() 均为非空，则要求有符号并匹配这些字符串的首字符之一。若这些字符串之一为空，则符号为可选（而若符号不存在，则结果的符号对应空的字符串的符号）。若两个字符均为空，或拥有相同首字符，则将正号给予结果。若输出参数为 string （ digits ）而结果为负，则存储值 ct.widen('-') 为结果的首字符。

如同按 digits 中出现的顺序释出并放置来自输入的数位，或将它们置于临时缓冲区 buf1 中（若需要则以 ct.widen() 加宽），再用下方式从该缓冲区构造 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 是另一充分大的字符缓冲区）

返回值

指向辨识为货币字符串输入的合法部分的末字符立即后一位置的迭代器。

注意

假定通货单位为通货的最小非小数单位：美国中为美分，日本中为日元。从而美国本地环境中的输入序列 "$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 提供到此函数的简化接口。

调用示例 windows

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
#include <vector>
#include <algorithm>
#include <iterator>
#include <Windows.h>

std::vector<std::wstring> locals;

BOOL CALLBACK MyFuncLocaleEx(LPWSTR pStr, DWORD dwFlags, LPARAM lparam)
{
    locals.push_back(pStr);
    return TRUE;
}

std::string stows(const std::wstring& ws)
{
    std::string curLocale = setlocale(LC_ALL, NULL); // curLocale = "C";
    setlocale(LC_ALL, "chs");
    const wchar_t* _Source = ws.c_str();
    size_t _Dsize = 2 * ws.size() + 1;
    char *_Dest = new char[_Dsize];
    memset(_Dest, 0, _Dsize);
    wcstombs(_Dest, _Source, _Dsize);
    std::string result = _Dest;
    delete[]_Dest;
    setlocale(LC_ALL, curLocale.c_str());
    return result;
}

void demo_money_get(std::locale locale, const std::string& input)
{
    std::cout << "in locale " << locale.name() << " : ";
    std::istringstream str(input);
    str.imbue(locale);

    long double units;
// 注意：下列代码能简单地写成 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>>(locale).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()
{
    EnumSystemLocalesEx(MyFuncLocaleEx, LOCALE_ALTERNATE_SORTS, NULL, NULL);

    for (std::vector<std::wstring>::const_iterator str = locals.begin();
            str != locals.end(); ++str)
    {
        demo_money_get(std::locale(stows(*str)), "-$5.12");
        demo_money_get(std::locale(stows(*str)), "￥5.12");
    }

    return 0;
}

输出

in locale de-DE_phoneb : Parse failed. Unparsed string: '$5.12'
in locale de-DE_phoneb : Parse failed. Unparsed string: '￥5.12'
in locale es-ES_tradnl : Parse failed. Unparsed string: '$5.12'
in locale es-ES_tradnl : Parse failed. Unparsed string: '￥5.12'
in locale hu-HU_technl : Parse failed. Unparsed string: '$5.12'
in locale hu-HU_technl : Parse failed. Unparsed string: '￥5.12'
in locale ja-JP_radstr : Parse failed. Unparsed string: '$5.12'
in locale ja-JP_radstr : Parse failed. Unparsed string: '￥5.12'
in locale ka-GE_modern : Parse failed. Unparsed string: '$5.12'
in locale ka-GE_modern : Parse failed. Unparsed string: '￥5.12'
in locale x-IV_mathan : Parse failed. Unparsed string: '$5.12'
in locale x-IV_mathan : Parse failed. Unparsed string: '￥5.12'
in locale zh-CN_phoneb : Parse failed. Unparsed string: '$5.12'
in locale zh-CN_phoneb : Successfully parsed '￥5.12' as 5.12 units
The input was fully consumed
in locale zh-CN_stroke : Parse failed. Unparsed string: '$5.12'
in locale zh-CN_stroke : Successfully parsed '￥5.12' as 5.12 units
The input was fully consumed
in locale zh-HK_radstr : Parse failed. Unparsed string: '$5.12'
in locale zh-HK_radstr : Parse failed. Unparsed string: '￥5.12'
in locale zh-MO_radstr : Parse failed. Unparsed string: '$5.12'
in locale zh-MO_radstr : Parse failed. Unparsed string: '￥5.12'
in locale zh-MO_stroke : Parse failed. Unparsed string: '$5.12'
in locale zh-MO_stroke : Parse failed. Unparsed string: '￥5.12'
in locale zh-SG_phoneb : Successfully parsed '-$5.12' as -5.12 units
The input was fully consumed
in locale zh-SG_phoneb : Parse failed. Unparsed string: '￥5.12'
in locale zh-SG_stroke : Successfully parsed '-$5.12' as -5.12 units
The input was fully consumed
in locale zh-SG_stroke : Parse failed. Unparsed string: '￥5.12'
in locale zh-TW_pronun : Parse failed. Unparsed string: '$5.12'
in locale zh-TW_pronun : Parse failed. Unparsed string: '￥5.12'
in locale zh-TW_radstr : Parse failed. Unparsed string: '$5.12'
in locale zh-TW_radstr : Parse failed. Unparsed string: '￥5.12'