localeconvlocaleconv

ロケールの設定に関する詳細情報を取得します。Gets detailed information on locale settings.

構文Syntax

struct lconv *localeconv( void );

戻り値Return Value

localeconv型の埋め込まれたオブジェクトへのポインターを返します、 struct lconvです。localeconv returns a pointer to a filled-in object of type struct lconv. オブジェクトに含まれる値は、スレッドローカルストレージのロケール設定からコピーされ、その後localeconvへの呼び出しによって上書きされる可能性があります。The values contained in the object are copied from the locale settings in thread-local storage, and can be overwritten by subsequent calls to localeconv. このオブジェクトの値を変更しても、ロケールの設定は変更されません。Changes made to the values in this object do not modify the locale settings. Category値がLC_ALLLC_MONETARY、またはLC_NUMERICsetlocaleを呼び出すと、構造体の内容が上書きされます。Calls to setlocale with category values of LC_ALL, LC_MONETARY, or LC_NUMERIC overwrite the contents of the structure.

RemarksRemarks

Localeconv関数は、現在のロケールの数値書式設定に関する詳細情報を取得します。The localeconv function gets detailed information about numeric formatting for the current locale. この情報は、lconv 型の構造体で格納されます。This information is stored in a structure of type lconv. lconv 構造体は、LOCALE.H で定義され、次のメンバーが含まれます。The lconv structure, defined in LOCALE.H, contains the following members:

フィールドField 説明Meaning
decimal_point,decimal_point,
_W_decimal_point_W_decimal_point
通貨数量の数量の小数点文字へのポインター。Pointer to decimal-point character for nonmonetary quantities.
thousands_sep,thousands_sep,
_W_thousands_sep_W_thousands_sep
通貨数量の数量の小数点の左にある数字のグループを区切る文字へのポインター。Pointer to character that separates groups of digits to left of decimal point for nonmonetary quantities.
グループ化 (grouping)grouping 通貨数量数量の各桁のグループのサイズを格納するcharサイズの整数へのポインター。Pointer to a char-sized integer that contains the size of each group of digits in nonmonetary quantities.
int_curr_symbol,int_curr_symbol,
_W_int_curr_symbol_W_int_curr_symbol
現在のロケールの国際通貨記号へのポインター。Pointer to international currency symbol for current locale. 最初の 3 文字は、ISO 4217 Codes for the Representation of Currency and Funds 規格で定義されている英字の国際通貨記号を指定します。First three characters specify alphabetic international currency symbol as defined in the ISO 4217 Codes for the Representation of Currency and Funds standard. 4 文字目 (null 文字の直前) は、国際通貨記号と通貨の数量を区切ります。Fourth character (immediately preceding null character) separates international currency symbol from monetary quantity.
符号currency_symbol,
_W_currency_symbol_W_currency_symbol
現在のロケールの現地通貨記号へのポインター。Pointer to local currency symbol for current locale.
mon_decimal_point,mon_decimal_point,
_W_mon_decimal_point_W_mon_decimal_point
通貨数量の小数点文字へのポインター。Pointer to decimal-point character for monetary quantities.
mon_thousands_sep,mon_thousands_sep,
_W_mon_thousands_sep_W_mon_thousands_sep
通貨数量の小数点以下の桁のグループの区切り記号へのポインター。Pointer to separator for groups of digits to left of decimal place in monetary quantities.
mon_groupingmon_grouping 通貨数量の各桁のグループのサイズを格納するcharサイズの整数へのポインター。Pointer to a char-sized integer that contains the size of each group of digits in monetary quantities.
positive_sign,positive_sign,
_W_positive_sign_W_positive_sign
負でない通貨数量の符号を示す文字列。String denoting sign for nonnegative monetary quantities.
negative_sign,negative_sign,
_W_negative_sign_W_negative_sign
負の通貨数量の符号を示す文字列。String denoting sign for negative monetary quantities.
int_frac_digitsint_frac_digits 国際方式で書式化された通貨数量の小数点より右側の桁数。Number of digits to right of decimal point in internationally formatted monetary quantities.
frac_digitsfrac_digits 書式化された通貨数量の小数点より右側の桁数。Number of digits to right of decimal point in formatted monetary quantities.
p_cs_precedesp_cs_precedes 書式化された負でない通貨数量の値の前に通貨記号が付く場合は、1 に設定します。Set to 1 if currency symbol precedes value for nonnegative formatted monetary quantity. 値の後に記号が続く場合は、0 に設定します。Set to 0 if symbol follows value.
p_sep_by_spacep_sep_by_space 書式化された負でない通貨数量の値と通貨記号をスペースで区切る場合は、1 に設定します。Set to 1 if currency symbol is separated by space from value for nonnegative formatted monetary quantity. スペースで区切らない場合は、0 に設定します。Set to 0 if there is no space separation.
n_cs_precedesn_cs_precedes 書式化された負の通貨数量の値の前に通貨記号が付く場合は、1 に設定します。Set to 1 if currency symbol precedes value for negative formatted monetary quantity. 値の後に記号が続く場合は、0 に設定します。Set to 0 if symbol succeeds value.
n_sep_by_spacen_sep_by_space 書式化された負の通貨数量の値と通貨記号をスペースで区切る場合は、1 に設定します。Set to 1 if currency symbol is separated by space from value for negative formatted monetary quantity. スペースで区切らない場合は、0 に設定します。Set to 0 if there is no space separation.
p_sign_posnp_sign_posn 書式化された負でない通貨数量での正符号の位置。Position of positive sign in nonnegative formatted monetary quantities.
n_sign_posnn_sign_posn 書式化された負の通貨数量での正符号の位置。Position of positive sign in negative formatted monetary quantities.

指定されている場合を除き、とwchar_t *のバージョンchar *を持つlconv構造体のメンバーは、文字列へのポインターです。Except as specified, members of the lconv structure that have char * and wchar_t * versions are pointers to strings. これらのいずれかが "" ( wchar_t *の場合はL " ) に等しいか、現在のロケールではサポートされていません。Any of these that equals "" (or L"" for wchar_t *) is either of zero length or not supported in the current locale. Decimal_point_W_decimal_pointは常にサポートされ、長さは0以外であることに注意してください。Note that decimal_point and _W_decimal_point are always supported and of nonzero length.

構造体のcharメンバーは、文字ではなく、小さい負以外の数値です。The char members of the structure are small nonnegative numbers, not characters. そのいずれかが CHAR_MAX に相当する場合は、現在のロケールではサポートされていません。Any of these that equals CHAR_MAX is not supported in the current locale.

Groupingmon_groupingの値は、次の規則に従って解釈されます。The values of grouping and mon_grouping are interpreted according to the following rules:

  • CHAR_MAX -それ以上のグループ化を実行しません。CHAR_MAX - Do not perform any further grouping.

  • 0: 残りの数字のそれぞれに対して previous 要素を使用します。0 - Use previous element for each of remaining digits.

  • n -現在のグループを構成する数字の数。n - Number of digits that make up current group. 次の要素が調べられて、現在のグループの前にある次のグループのサイズが決定されます。Next element is examined to determine size of next group of digits before current group.

int_curr_symbol の値は、次の規則に従って解釈されます。The values for int_curr_symbol are interpreted according to the following rules:

  • 最初の 3 文字は、ISO 4217 Codes for the Representation of Currency and Funds 規格で定義されている英字の国際通貨記号を指定します。The first three characters specify the alphabetic international currency symbol as defined in the ISO 4217 Codes for the Representation of Currency and Funds standard.

  • 4 文字目 (null 文字の直前) は、国際通貨記号と通貨の数量を区切ります。The fourth character (immediately preceding the null character) separates the international currency symbol from the monetary quantity.

p_cs_precedesn_cs_precedes の値は、次の規則に従って解釈されます (かっこ内は n_cs_precedes 規則です)。The values for p_cs_precedes and n_cs_precedes are interpreted according to the following rules (the n_cs_precedes rule is in parentheses):

  • 0-通貨記号は、負でない (負の) 書式設定された通貨値の値に従います。0 - Currency symbol follows value for nonnegative (negative) formatted monetary value.

  • 1-通貨記号は、負でない (負の) 書式設定された通貨値の値よりも前になります。1 - Currency symbol precedes value for nonnegative (negative) formatted monetary value.

p_sep_by_spacen_sep_by_space の値は、次の規則に従って解釈されます (かっこ内は n_sep_by_space 規則です)。The values for p_sep_by_space and n_sep_by_space are interpreted according to the following rules (the n_sep_by_space rule is in parentheses):

  • 0-通貨記号は、負でない (負の) 書式設定された通貨値の値からスペースで区切られます。0 - Currency symbol is separated from value by space for nonnegative (negative) formatted monetary value.

  • 1-通貨記号と負でない (負の) 書式設定された通貨値の間には空白を区別しません。1 - There is no space separation between currency symbol and value for nonnegative (negative) formatted monetary value.

p_sign_posnn_sign_posn の値は、次の規則に従って解釈されます。The values for p_sign_posn and n_sign_posn are interpreted according to the following rules:

  • 0: [数量] と [通貨記号] をかっこで囲みます。0 - Parentheses surround quantity and currency symbol.

  • 1-署名文字列は、数量と通貨記号の前に付けます。1 - Sign string precedes quantity and currency symbol.

  • 2-署名文字列は、数量と通貨記号の後に続きます。2 - Sign string follows quantity and currency symbol.

  • 3-符号付き文字列は、通貨記号の直前にあります。3 - Sign string immediately precedes currency symbol.

  • 4-符号文字列は、通貨記号の直後に続きます。4 - Sign string immediately follows currency symbol.

必要条件Requirements

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

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

ライブラリLibraries

C ランタイム ライブラリのすべてのバージョン。All versions of the C run-time libraries.

関連項目See also

ロケールLocale
setlocalesetlocale
strcoll 系関数strcoll Functions
strftime、wcsftime、_strftime_l、_wcsftime_lstrftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_lstrxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l