Cライブラリ関数 -uselocale()
説明
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オブジェクトは現在のスレッドのローカリゼーションオブジェクトとして設定されます。
- NULL の場合
戻り値
- 成功時、以前の
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;
}
#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:
コード解析
-
新しいローカリゼーションオブジェクトの作成:
- 使用して
newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)新しいローカリゼーションオブジェクトを作成し、ロケール設定を "en_US.UTF-8" に設定します。
- 使用して
-
デフォルトのローカリゼーション情報の表示:
- 使用して
localeconv()小数点文字や桁区切り文字など、現在のデフォルトのローカリゼーション情報を取得して表示します。
- 使用して
-
スレッドのローカリゼーションオブジェクトの設定:
- 使用して
uselocale(newloc)現在のスレッドのローカリゼーションオブジェクトを新しく作成したローカリゼーションオブジェクトに設定し、以前のローカリゼーションオブジェクトを保存します。
- 使用して
-
新しいローカリゼーション情報の表示:
- 使用して
localeconv()新しいローカリゼーション情報を取得して表示し、切り替えが成功したかどうかを検証します。
- 使用して
-
以前のローカリゼーションオブジェクトの復元:
- 使用して
uselocale(oldloc)以前のローカリゼーションオブジェクトを復元します。
- 使用して
-
ローカリゼーションオブジェクトの解放:
- 使用して
freelocale(newloc)新しく作成したローカリゼーションオブジェクトを解放し、メモリリークを防ぎます。
- 使用して
注意事項
uselocale()関数は POSIX.1-2008 標準の一部であり、お使いのプラットフォームがこの関数をサポートしていることを確認してください。- マルチスレッド環境で使用すると、
uselocale()スレッドごとに独立したローカリゼーションオブジェクトを設定できますが、スレッド間のデータ一貫性と競合状態に注意してください。 - 使用して
freelocale()不要になったローカリゼーションオブジェクトを解放し、メモリリークを避けます。
まとめ
uselocale()関数を使用すると、現在のスレッドのローカリゼーションオブジェクトを設定および取得でき、マルチスレッド環境でのローカリゼーションサポートを実現します。組み合わせて使用することで、newlocale()、uselocale()とfreelocale()プログラマーはプログラムのローカリゼーション設定を柔軟に管理および切り替え、異なるスレッドに独立したロケール設定を提供できます。
C標準ライブラリ - <locale.h>