localeconv

  • [アーティクル]

ロケールの設定に関する詳細情報を取得します。

構文

struct lconv *localeconv( void );

戻り値

localeconv は、 struct lconv型の塗りつぶされたオブジェクトへのポインターを返します。 オブジェクトに含まれる値は、スレッド ローカル ストレージのロケール設定からコピーされ、後続の localeconv の呼び出しによって上書きできます。 このオブジェクトの値を変更しても、ロケール設定は変更されません。 LC_ALL、LC_MONETARY、またはLC_NUMERICのcategory値を持つsetlocaleを呼び出して、構造体の内容を上書きします。

解説

localeconv 関数は、現在のロケールにおける数値の書式設定に関する詳細情報を取得します。 この情報は、 lconv型の構造体に格納されます。 LOCALE で定義されている lconv 構造体。H には、次のメンバーが含まれています。

フィールド 意味
decimal_point,
_W_decimal_point		 通貨でない数量の小数点文字へのポインター。
thousands_sep,
_W_thousands_sep		 通貨でない数量の小数点の左側にある数字のグループを区切る文字へのポインター。
grouping 通貨でない数量の数字の各グループのサイズが含まれている char サイズの整数へのポインター。
int_curr_symbol,
_W_int_curr_symbol		 現在のロケールの国際通貨記号へのポインター。 最初の 3 文字は、ISO 4217 Codes for the Representation of Currency and Funds 規格で定義されている英字の国際通貨記号を指定します。 4 文字目 (null 文字の直前) は、国際通貨記号と通貨の数量を区切ります。
currency_symbol,
_W_currency_symbol		 現在のロケールの国内通貨記号へのポインター。
mon_decimal_point,
_W_mon_decimal_point		 通貨数量の小数点文字へのポインター。
mon_thousands_sep,
_W_mon_thousands_sep		 通貨数量の小数点の左側にある数字のグループの区切り文字へのポインター。
mon_grouping 通貨数量の数字の各グループのサイズが含まれている char サイズの整数へのポインター。
positive_sign,
_W_positive_sign		 負でない通貨数量の符号を示す文字列。
negative_sign,
_W_negative_sign		 負の通貨数量の符号を示す文字列。
int_frac_digits 国際方式で書式化された通貨数量の小数点より右側の桁数。
frac_digits 書式化された通貨数量の小数点より右側の桁数。
p_cs_precedes 書式化された負でない通貨数量の値の前に通貨記号が付く場合は、1 に設定します。 値の後に記号が続く場合は、0 に設定します。
p_sep_by_space 書式化された負でない通貨数量の値と通貨記号をスペースで区切る場合は、1 に設定します。 スペースの分離がない場合は 0 に設定します。
n_cs_precedes 書式化された負の通貨数量の値の前に通貨記号が付く場合は、1 に設定します。 値の後に記号が続く場合は、0 に設定します。
n_sep_by_space 書式化された負の通貨数量の値と通貨記号をスペースで区切る場合は、1 に設定します。 スペースの分離がない場合は 0 に設定します。
p_sign_posn 負でない形式の通貨数量で、正符号の位置。
n_sign_posn 負の書式設定された通貨数量で、正符号の位置。

指定されている場合を除き、char *バージョンとwchar_t *バージョンを持つlconv構造体のメンバーは文字列へのポインターです。 "" (またはwchar_t *のL"") と等しいメンバーは、長さが 0 であるか、現在のロケールではサポートされていません。 decimal_pointと_W_decimal_pointの両方が常にサポートされ、0 以外の長さになります。

構造体の char メンバーは、文字ではなく、負以外の小さい数値です。 CHAR_MAX等しいメンバーは、現在のロケールではサポートされていません。

groupingとmon_groupingの値は、次の規則に従って解釈されます。

  • CHAR_MAX - これ以上グループ化を実行しないでください。

  • 0 - 残りの各桁に前の要素を使用します。

  • n - 現在のグループを構成する桁数。 次の要素が調べられて、現在のグループの前にある次のグループのサイズが決定されます。

int_curr_symbolの値は、次の規則に従って解釈されます。

  • 最初の 3 文字は、ISO 4217 Codes for the Representation of Currency and Funds 規格で定義されている英字の国際通貨記号を指定します。

  • 4 文字目 (null 文字の直前) は、国際通貨記号と通貨の数量を区切ります。

p_cs_precedesとn_cs_precedesの値は、次の規則に従って解釈されます (n_cs_precedes規則はかっこ内)。

  • 0 - 通貨記号は、負でない (負の) 書式設定された通貨値の値の後に置かれます。

  • 1 - 通貨記号は、負でない (負の) 書式設定された通貨値の値の前に置かれます。

p_sep_by_spaceとn_sep_by_spaceの値は、次の規則に従って解釈されます (n_sep_by_space規則はかっこ内)。

  • 0 - 通貨記号は、負でない (負の) 書式設定された通貨値の値とはスペースで区切られます。

  • 1 - 通貨記号と、負でない (負の) 書式設定された通貨値の値の間にスペースの分離はありません。

p_sign_posnとn_sign_posnの値は、次の規則に従って解釈されます。

  • 0 - 数量と通貨記号をかっこで囲みます。

  • 1 - 符号文字列は、数量と通貨記号の前に置かれます。

  • 2 - 符号文字列は、数量と通貨記号の後に置かれます。

  • 3 - 符号文字列は、通貨記号の直前に置かれます。

  • 4 - 符号文字列は、通貨記号の直後に置かれます。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

要件

ルーチンによって返される値 必須ヘッダー
localeconv <locale.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

関連項目

ロケール
setlocale
strcoll 関数
strftime、 wcsftime、 _strftime_l、 _wcsftime_l
strxfrm、 wcsxfrm、 _strxfrm_l、 _wcsxfrm_l