std:: locale

std::locale クラスのオブジェクトは、不変なファセットの不変なインデックス付き集合です。C++入出力ライブラリの各ストリームオブジェクトは std::locale オブジェクトに関連付けられ、そのファセットを使用して全てのデータのパースとフォーマットを行います。 さらに、ロケールオブジェクトは各 std::basic_regex オブジェクトに関連付けられます。 (C++11以降) ロケールオブジェクトは、標準コンテナとアルゴリズムで文字列照合を実行する述語として使用することもでき、保持するファセットを取得または変更するために直接アクセスすることもできます。

C++プログラムで構築される各ロケールは、少なくとも以下の標準ファセットを保持します（つまり、 std::has_facet はこれらのファセットタイプ全てに対して true を返します）。ただし、プログラムは追加の特殊化または完全に新しいファセットを定義し、既存のロケールオブジェクトに追加することができます。

内部的には、ロケールオブジェクトは、参照カウント方式のポインタの配列（ std::locale::id でインデックス付け）への参照カウント方式のポインタとして実装されています：ロケールをコピーする場合は、単一のポインタをコピーし、いくつかの参照カウントをインクリメントするだけです。標準C++ライブラリのスレッド安全性保証（異なるオブジェクトに対する操作は常にスレッドセーフ）を維持するために、ロケールの参照カウントと各ファセットの参照カウントは、 std::shared_ptr と同様に、スレッドセーフな方法で更新されます。

メンバー型

メンバー定数

std::locale のメンバ関数で category 引数を期待するものは、上記で定義されたカテゴリ値、または2つ以上のそのような値の組み合わせを必要とします。 LC 定数 は受け入れられません。

メンバー関数

例

#include <iostream>
#include <locale>
int main()
{
    std::wcout << L"User-preferred locale setting is "
               << std::locale("").name().c_str() << L'\n';
    // on startup, the global locale is the "C" locale
    std::wcout << 1000.01 << L'\n';
    // replace the C++ global locale and the "C" locale with the user-preferred locale
    std::locale::global(std::locale(""));
    // use the new global locale for future wide character output
    std::wcout.imbue(std::locale());
    // output the same number again
    std::wcout << 1000.01 << L'\n';
}

User-preferred locale setting is en_US.UTF8
1000.01
1,000.01

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目