C ライブラリ関数 -newlocale()
説明
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;
}
#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>