C ライブラリ関数 -newlocale()

C 标准库 - <locale.h>C 標準ライブラリ - <locale.h>

説明

newlocale()は C 標準ライブラリ内の関数で、新しいローカライズオブジェクトを作成するために使用されます。この関数を使用すると、プログラムは特定のロケール設定を作成でき、既存のロケール設定に基づいて変更または拡張することもできます。

宣言

以下は newlocale() 関数の宣言です。

#include <locale.h>

locale_t newlocale(int category_mask, const char *locale, locale_t base);

引数

  • category_mask:設定する1つ以上のローカライズカテゴリのマスク。以下のマクロの組み合わせにすることができます(ビット単位のOR演算子による|組み合わせ):

    • LC_COLLATE_MASK:文字列比較に関連するローカライズ情報。
    • LC_CTYPE_MASK:文字分類と変換に関連するローカライズ情報。
    • LC_MONETARY_MASK:通貨形式に関連するローカライズ情報。
    • LC_NUMERIC_MASK:数値形式に関連するローカライズ情報。
    • LC_TIME_MASK:時刻形式に関連するローカライズ情報。
    • LC_MESSAGES_MASK:メッセージ表示に関連するローカライズ情報。
    • LC_ALL_MASK:すべてのローカライズカテゴリ。
  • locale:設定するロケール名を指定する文字列(例:"en_US.UTF-8")。もしNULLの場合は、デフォルトのロケール設定が使用されます。

  • base:既存のlocale_tオブジェクトで、新しいローカライズオブジェクトを作成するための基礎として使用されます。もしNULLの場合は、最初から新しいオブジェクトが作成されます。

戻り値

  • 成功時は、新しく作成されたローカライズオブジェクトを返します(型はlocale_t)。
  • 失敗時は、返しますNULL。

例

以下は、newlocale() を使用して新しいローカライズオブジェクトを作成および使用するサンプルコードです:

例

#include <stdio.h>
#include <locale.h>
#include <xlocale.h> // GNU 拡張を使用する場合に必要

int main() {
    // "en_US.UTF-8" ロケール設定を使用して新しいローカライズオブジェクトを作成する
    locale_t newloc = newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0);
    if (newloc == (locale_t)0) {
        perror("newlocale");
        return 1;
    }

    // 現在のスレッドのローカライズオブジェクトを新しいローカライズオブジェクトに設定する
    locale_t oldloc = uselocale(newloc);

    // 現在のローカライズ情報を取得して出力する
    struct lconv *lc = localeconv();
    printf("Decimal point character in new locale: %s\n", lc->decimal_point);
    printf("Thousands separator in new locale: %s\n", lc->thousands_sep);

    // 以前のローカライズオブジェクトを復元する
    uselocale(oldloc);

    // 新しいローカライズオブジェクトを解放する
    freelocale(newloc);

    return 0;
}

上記のプログラムをコンパイルして実行すると、次の結果が得られます:

Decimal point character in new locale: .
Thousands separator in new locale: ,

コード解析

新しいローカライズオブジェクトの作成

  • newlocale(LC_ALL_MASK, "en_US.UTF-8", NULL):"en_US.UTF-8" ロケール設定を使用し、デフォルトのローカライズオブジェクトに基づいて、新しいローカライズオブジェクトを作成します。
  • newlocale(LC_NUMERIC_MASK | LC_TIME_MASK, "fr_FR.UTF-8", NULL):"fr_FR.UTF-8"(フランス語 - フランス)を数値形式と時刻形式に設定し、その他のカテゴリはデフォルト設定を使用して、新しいローカライズオブジェクトを作成します。

スレッドのローカライズオブジェクトの設定

  • を使用してuselocale(newloc)現在のスレッドのローカライズオブジェクトを新しく作成されたローカライズオブジェクトに設定します。
  • を使用してuselocale(oldloc)以前のローカライズオブジェクトを復元します。

ローカライズオブジェクトの解放

  • を使用してfreelocale(newloc)新しく作成されたローカライズオブジェクトを解放し、メモリリークを防ぎます。

注意事項

  • newlocale()は POSIX.1-2008 標準の一部であり、すべてのプラットフォームでサポートされているわけではありません。GNU C ライブラリを使用する場合は、<xlocale.h>ヘッダーファイルを必ず含めてください。
  • newlocale()返されたlocale_tオブジェクトは渡すことができますuselocale()関数に渡すことで、スレッド内で一時的に異なるロケール設定を使用できます。

まとめ

newlocale()この関数により、新しいローカライズオブジェクトの作成と使用が可能になり、プログラムがさまざまなロケール設定やローカライズ要件を処理できるようになります。newlocale()、uselocale()とfreelocale()関数を組み合わせることで、プログラマーはプログラムのローカライズ情報をより柔軟に管理および切り替えることができ、国際化アプリケーションの開発をサポートできます。

C 标准库 - <locale.h>C 標準ライブラリ - <locale.h>

その他の拡張