C++ 中的 std::money_put 函数

引言

std::money_put 函数是 C++ 标准库的标准功能之一，包含在 <locale> 头文件中，旨在实现本地化。这个模板类专门用于处理货币值的格式化和渲染，以确保它们能恰当地反映世界各地本地化的标准。它对于确定货币金额的定位非常有用，这对于任何需要表示不同地区金融金额的程序来说都是必需的。

作为标准库本地化框架的一部分，std::money_put 补充了输出流，以便开发人员能够格式化和打印符合本地化设置的货币值。这包括正确表示货币符号、小数点和千位分隔符，这些在不同本地化设置中是不同的。

std::money_put 模板支持单字符和宽字符类型，使其更加通用，适用于不同用途。它拥有多个成员类型和函数，可以对货币值的格式化进行精细调整。此外，std::money_put 内部还有受保护的成员函数和对象，可确保其高效运行并扩展其功能。

在接下来的章节中，我们将深入探讨 std::money_put 的具体细节，描述 <locale> 头文件中包含的 std::money_put，以及该模板的位置和包含方式。我们将探讨适用于不同字符类型的各种特化，以及 std::money_put 模板中定义的成员类型。还将讨论与货币值格式化相关的成员函数，以及在模板功能中扮演关键角色的受保护成员函数。此外，我们还将研究 std::money_put 模板中的成员对象。最后，将提供一个实际的代码示例来说明 std::money_put 的用法，用于提供货币值的格式化和输出。通过探讨这些子主题，我们将全面了解 std::money_put 及其在 C++ 程序中控制货币值格式化方面的用途。

定义于头文件 <locale>

std::money_put 策略声明在 C++ 标准库的开头，其名称为 money_put。此头文件包含多个函数，可根据特定文化的描述执行操作，从而使程序能够以完全国际化的方式运行。通过包含 <locale>，开发人员可以访问一系列本地化功能，包括 std::money_put 类，该类专门用于定义当前本地化设置中货币值的格式化规则。这就是为什么在任何管理和显示财务数据的应用程序中都必须包含 <locale> 头文件，以便正确显示货币符号、小数点和其他特定于本地化的格式细节，从而获得应用程序的最佳功能。

语法

特化

std::money_put 模板的具体实现是为字符类型设计的，这使其能够适应性强，并能处理各种字符串表示。标准库保证了以下特化，任何本地化对象都必须实现它们：

• std::money_put<char>

此特化生成表示精确货币值的字符串，适用于窄字符流。

• std::money_put<wchar_t>

此特化生成用于表示货币值的宽字符字符串，适用于宽字符流。

除了这些保证的特化之外，还有一些遵循标准库设定的特定条件的函数的特化。这些要求是：

CharT：字符类型必须从以下列表中选择：

• char
• wchar_t
• 除了上面提到的字符类型之外，用于实现平台上任何元素的字符的任何其他类型的容器都必须满足字符的要求。
• Output：必须提到，类型 IT 必须满足 LegacyOutputIterator 的要求，以便能够将格式化后的货币值写入输出流。

这些特化允许 std::money_put 与各种字符类型和输出迭代器一起使用。因此，新方法 money_put 应该可以与所有类型的字符和输出迭代器一起使用，使其成为在不同 C++ 应用程序中格式化货币值的有用功能。

成员类型

std::money_put 模板具有多个成员类型，如下所述；这些成员类型对模板的运行至关重要。它们有助于使模板更加通用，以便能够与大多数字符和迭代器类型一起使用。以下是 std::money_put 模板中定义的关键成员类型，可附加已编码函数。

• char_type

此成员类型是 typedef 类型，指向 std::money_put 特化要使用的字符类型。它定义为 CharT，它可以是 char（适用于 ANSI C89 及更早版本）或 wchar_t（适用于 ANSI C90 及更高版本）或 iostreams 所需的任何其他字符类型。

• string_type

此成员类型表示一个字符串类型，该字符串类型等同于此令牌数据对象的字符类型。它定义为 std::basic_string<CharT>，因为程序应该接受 basic_string<CharT>，从而能够对所需字符类型使用字符串操作。

• iter_type

此成员类型定义了输出操作中涉及的迭代器类型（如果有）。它定义为 OutputIt，它必须满足 LegacyOutputIterator 的要求。这允许两件事；首先，迭代器可用于将格式化后的货币值写入输出流。

这些成员类型构成了 std::money_put 的基础，以促进其策略，包括 money_put 模板，使其与不同的字符编码和输出迭代器兼容。

成员函数

std::money_put 类型类提供了多个成员函数，这些函数有助于构建它并使用它来格式化货币值。这些函数未定义。

• 构造函数

它构建了一个新的 money_put 类。构造函数接受一个可选参数，即引用计数 refs，用于初始化该类。此参数由本地化管理系统内部使用，以处理类的生命周期。

• Put

put 函数是用于格式化和打印货币值的主要外部方法。它使用受保护的成员函数 do_put 来执行实际格式化。put 函数有两个重载版本：

• 第一个版本仅格式化一个 long double 货币值。
• 第二个版本转换字符串格式的货币值。

这些函数确保货币类型的值根据适用的规则根据本地化设置进行格式化，并传递给输出迭代器。

这些成员函数使 **std::money_put** 类能够用于涉及根据本地化设置格式化和输出货币值的应用程序。

受保护的成员函数

std::money_put 模板包含多个受保护的成员函数来支持其操作。这些函数通常由类内部使用，不应由用户代码直接调用。关键的受保护成员函数是：

• 析构函数

析构函数负责清理 money_put 类。作为虚析构函数，它确保派生类可以在必要时对其进行重写，从而在多态使用场景中实现适当的资源管理和清理。

• do_put

do_put 函数是一个虚受保护的成员函数，它执行货币值的实际格式化并将其写入输出流。此函数有两个重载版本：

• 第一个版本格式化一个 long double 货币值。
• 第二个版本格式化一个以字符串形式提供的货币值。

这些函数由公共 put 函数调用以执行格式化操作。通过使 do_put 成为受保护的虚函数，std::money_put 允许在派生类中进行自定义和扩展，从而为不同的本地化或自定义格式化需求实现专门的行为。

这些受保护的成员函数确保 **std::money_put** 可以正确管理其资源，并提供一种灵活的机制，用于根据特定于本地化的规则格式化货币值。

成员对象

std::money_put 模板目前使用特定的成员对象来启用其在本地化系统中的操作。关键成员对象是：

• static std::locale::id id

这个标准的全局对象在本地化空间内声明 money_put 类。标准类带有一个特定的 id，该 id 用于在本地化框架中对其进行标识和操作。幸运的是，存在一个 id 对象，以确保在根据给定本地化的规则格式化货币时，将提取并应用正确的类。

此成员对象在 std::money_put 模板的功能中起着至关重要的作用，它促进了该模板被标记并纳入 C++ 的通用本地化管理技术中。

示例

输出

10002 --> 10002
10002 --> 10002

=== Code Execution Successful ===

说明

• 此代码演示了 std::money_put 的用法。它还定义并使用了 std::money_put 来将格式化规则应用于准备输出的值。它从包含程序所需头文件开始，例如用于本地化相关操作的 <locale>，用于输入输出操作的 <iostream>，用于迭代器使用的 <iterator>，以及最后用于字符串操作的 <string>。
• 在 main 函数内部，它定义了一个 typedef Iter 为 std::ostreambuf_iterator<char>，以方便使用。
• 好了，这解释了为什么我们的输出与 htmlspecialchars 测试中的 C printf() 略有不同。然后它声明了一个输入字符串“10002”和一个 long double 变量，其输入也是“10002”。
• 代码构造了一个 ostreambuf_iterator，指向 std::cout，以便进行输出操作/操作。它创建了一个 std::locale 对象，用于表示当前本地化。使用 std::locale::use_facet，它返回与该特定本地化相关的 money 类，并将其保存在一个名为 money_put_facet 的变量中。
• 然后格式化并输出了两个货币值：第一个是字符串中字符的 ASCII 值，构成了输入值“10002”，第二个是实际数值 10002。这可以通过利用 money_put 类的 put 函数来完成，该函数接受所需的输出迭代器、国际标志、输出流、要使用的字符、千位分隔符，然后将值放入。
• 最后，程序将格式化后的货币值打印到 std::cout 并终止。

std::money_put 的优点和缺点

在 C++ 中使用 std::money_put 既有优点也有缺点。

优点

• 本地化敏感格式化

std::money_put 是一个类，它能够根据给定程序中使用的当前本地化设置来格式化货币值。它确保格式化的货币值能够符合本地化标准，例如当前使用的货币符号、小数点和千位分隔符。它还有助于支持不同世界地区和文化中货币之间相同金额的相似性和差异性，这在翻译时至关重要。

• 灵活性

money_put 类提供了用于呈现货币值的细化选择。它通过允许程序员选择格式化参数（例如“是/否”选项，包括国际数字格式化、千位分隔符字符和其他选项）来完全控制格式化过程。因此，通过采用满足特定用户或业务需求所需的格式化样式来实现格式控制。

• 与标准流集成

std::money_put 与 std::cout 和 std::ostringstream 等标准流协同工作。这使得它易于与涉及货币值的其他 I/O 函数集成，因为它基本上为这些函数添加了格式化属性。

• 与标准库的一致性

std::money_put 也是 C++ 标准库的组成部分，这意味着它应该具有可移植性，并与许多不同的系统和库兼容。因此，这个标准设施是为开发人员开发的，以便他们可以依赖它来获得一致的行为和性能特征。

缺点

• 自定义复杂性

尽管可以轻松地重写 std::money_put 以扩展其格式化选项的功能，但要实现超出这些选项的格式化行为可能并不容易。这可能导致使用基元和自定义类来处理流，这可能在低级别并且会影响代码的可读性。

• 对复杂格式化的支持有限

std::money_put 主要用于基本的货币值表示，涉及货币符号位置和小数点位置。当需要其他格式化（例如支持其他自定义货币符号或支持其他动态数据源的格式化）时，它可能无法提供所需的格式化。在这些情况下，开发人员可能需要实现 std::money_put 之外的自定义格式化逻辑。同样重要的是要确保投入的资金得到妥善管理。

• 本地化依赖性

std::money_put 类使用本地化系统来决定数字的格式化方式，因此 std::money_put 的行为取决于当前本地化设置。一方面，这有助于保持与本地标准的合规性；另一方面，这也引入了受外部因素影响的应用程序行为的元素，例如本地化设置的更改或不同平台之间的差异。