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

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

説明

uselocale()C標準ライブラリ内の関数で、スレッドの現在のローカリゼーションオブジェクトを設定または取得するために使用されます。この関数により、プログラムは異なるスレッドで異なるロケール設定を使用でき、マルチスレッド環境でのローカリゼーションをサポートします。

宣言

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

#include <locale.h>

locale_t uselocale(locale_t newloc);

パラメータ

  • newloc: 現在のスレッドのローカリゼーションオブジェクトとして設定するlocale_tオブジェクト。
    • NULL の場合LC_GLOBAL_LOCALE、グローバルロケール設定を使用します。
    • LC_GLOBAL_LOCALE の場合NULL、現在のローカリゼーションオブジェクトを変更せず、現在のローカリゼーションオブジェクトのみを返します。
    • その他の有効なlocale_tオブジェクトは現在のスレッドのローカリゼーションオブジェクトとして設定されます。

戻り値

  • 成功時、以前のlocale_tオブジェクト(現在のスレッドのローカリゼーションオブジェクト)を返します。
  • 失敗時はLC_GLOBAL_LOCALEを返し、適切なエラーコードを設定します。

例

以下の例は、freelocale() を使用して 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;
    }

    // 現在のローカリゼーション情報を取得して表示
    struct lconv *lc = localeconv();
    printf("Default locale decimal point: %s\n", lc->decimal_point);
    printf("Default locale thousands separator: %s\n", lc->thousands_sep);

    // 現在のスレッドのローカリゼーションオブジェクトを新しいローカリゼーションオブジェクトに設定
    locale_t oldloc = uselocale(newloc);

    // 新しいローカリゼーション情報を取得して表示
    lc = localeconv();
    printf("New locale decimal point: %s\n", lc->decimal_point);
    printf("New locale thousands separator: %s\n", lc->thousands_sep);

    // 以前のローカリゼーションオブジェクトを復元
    uselocale(oldloc);

    // 復元後のローカリゼーション情報を取得して表示
    lc = localeconv();
    printf("Restored locale decimal point: %s\n", lc->decimal_point);
    printf("Restored locale thousands separator: %s\n", lc->thousands_sep);

    // 新しいローカリゼーションオブジェクトを解放
    freelocale(newloc);

    return 0;
}

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

Default locale decimal point: .
Default locale thousands separator: 
New locale decimal point: .
New locale thousands separator: ,
Restored locale decimal point: .
Restored locale thousands separator: 

コード解析

  1. 新しいローカリゼーションオブジェクトの作成:

    • 使用してnewlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)新しいローカリゼーションオブジェクトを作成し、ロケール設定を "en_US.UTF-8" に設定します。
  2. デフォルトのローカリゼーション情報の表示:

    • 使用してlocaleconv()小数点文字や桁区切り文字など、現在のデフォルトのローカリゼーション情報を取得して表示します。
  3. スレッドのローカリゼーションオブジェクトの設定:

    • 使用してuselocale(newloc)現在のスレッドのローカリゼーションオブジェクトを新しく作成したローカリゼーションオブジェクトに設定し、以前のローカリゼーションオブジェクトを保存します。
  4. 新しいローカリゼーション情報の表示:

    • 使用してlocaleconv()新しいローカリゼーション情報を取得して表示し、切り替えが成功したかどうかを検証します。
  5. 以前のローカリゼーションオブジェクトの復元:

    • 使用してuselocale(oldloc)以前のローカリゼーションオブジェクトを復元します。
  6. ローカリゼーションオブジェクトの解放:

    • 使用してfreelocale(newloc)新しく作成したローカリゼーションオブジェクトを解放し、メモリリークを防ぎます。

注意事項

  • uselocale()関数は POSIX.1-2008 標準の一部であり、お使いのプラットフォームがこの関数をサポートしていることを確認してください。
  • マルチスレッド環境で使用すると、uselocale()スレッドごとに独立したローカリゼーションオブジェクトを設定できますが、スレッド間のデータ一貫性と競合状態に注意してください。
  • 使用してfreelocale()不要になったローカリゼーションオブジェクトを解放し、メモリリークを避けます。

まとめ

uselocale()関数を使用すると、現在のスレッドのローカリゼーションオブジェクトを設定および取得でき、マルチスレッド環境でのローカリゼーションサポートを実現します。組み合わせて使用することで、newlocale()、uselocale()とfreelocale()プログラマーはプログラムのローカリゼーション設定を柔軟に管理および切り替え、異なるスレッドに独立したロケール設定を提供できます。

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

その他の拡張