ロケールの設定に関する詳細情報を取得します。
構文
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