localeconv

  • [アーティクル]

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

構文

struct lconv *localeconv( void );

戻り値

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

解説

localeconv 関数は、現在のロケールにおける数値の書式設定に関する詳細情報を取得します。 この情報は、型 lconvの構造体に格納されます。 lconv LOCALE で定義されている構造体。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 負の書式設定された通貨数量で、正符号の位置。

指定されている場合を lconv 除き、持つ char * 構造体のメンバーと wchar_t * バージョンは文字列へのポインターです。 等しい "" (または L"" for wchar_t *) メンバーは、長さが 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_precedesn_cs_precedes値は、次の規則に従って解釈されます (n_cs_precedesルールはかっこで囲まれています)。

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

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

p_sep_by_spacen_sep_by_space値は、次の規則に従って解釈されます (n_sep_by_spaceルールはかっこで囲まれています)。

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

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

p_sign_posnn_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