localeconv

取得地區設定上的詳細資訊。

語法

struct lconv *localeconv( void );

傳回值

localeconv 會傳回 類型 struct lconv 之填入物件的指標。 物件中包含的值會從執行緒本機儲存體的地區設定複製，並可由後續呼叫 localeconv 覆寫。 對這個物件中值所做的變更不會修改地區設定。 setlocale使用 category 、 LC_MONETARY 或 的值 LC_ALL 呼叫 ，或 LC_NUMERIC 覆寫 結構的內容。

備註

localeconv 函式取得有關目前地區設定之數值格式的詳細資訊。 這項資訊會儲存在 類型 lconv 的結構中。 結構 lconv ，定義于 LOCALE 中。H 包含下列成員：

欄位	意義
decimal_point, _W_decimal_point	非數位數的小數點字元指標。
thousands_sep, _W_thousands_sep	分隔非數位數小數點左邊之數位群組的字元指標。
grouping	char-sized 整數的指標，其中包含非數位數量中每個數位群組的大小。
int_curr_symbol, _W_int_curr_symbol	目前地區設定之國際貨幣符號的指標。 前三個字元依照「ISO 4217 貨幣和資金代碼」標準的定義，指定字母國際貨幣符號。 第四個字元 (緊接在 Null 字元之前) 會分隔國際貨幣符號與貨幣的數量。
currency_symbol, _W_currency_symbol	目前地區設定的本機貨幣符號指標。
mon_decimal_point, _W_mon_decimal_point	貨幣數量的小數點字元指標。
mon_thousands_sep, _W_mon_thousands_sep	以貨幣數量表示小數點左邊數位群組分隔符號的指標。
mon_grouping	char-sized 整數的指標，其中包含貨幣數量中每個數位群組的大小。
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 都是字串的指標。 任何等於 "" （或 L"" for wchar_t * ） 的成員都是零長度，或目前地區設定中不支援。 和 decimal_point_W_decimal_point 一律受到支援，且長度為非零。

結構 char 的成員是小型非負數，而不是字元。 目前地區設定不支援任何相等 CHAR_MAX 的成員。

和 mon_grouping 的值 grouping 會根據下列規則來解譯：

• CHAR_MAX - 不要執行任何進一步的分組。

• 0 - 針對每個剩餘數位使用先前的專案。

• n - 組成目前群組的位數。 檢查下一個項目，以在目前群組之前判斷下一個數字群組的大小。

的值 int_curr_symbol 會根據下列規則來解譯：

• 前三個字元依照「ISO 4217 貨幣和資金代碼」標準之定義，指定字母國際貨幣符號。

• 第四個字元 (緊接在 Null 字元之前) 會分隔國際貨幣符號與貨幣的數量。

和 n_cs_precedes 的值 p_cs_precedes 會根據下列規則來解譯（ n_cs_precedes 規則位於括弧中）：

• 0 - 貨幣符號會遵循非負值（負）格式貨幣值的值。

• 1 - 貨幣符號在非負值（負值）格式化貨幣值之前。

和 n_sep_by_space 的值 p_sep_by_space 會根據下列規則來解譯（ n_sep_by_space 規則位於括弧中）：

• 0 - 貨幣符號會以非負值（負值）格式化貨幣值的空間分隔。

• 1 - 貨幣符號與非負值（負值）格式貨幣值之間沒有空格分隔。

和 n_sign_posn 的值 p_sign_posn 會根據下列規則來解譯：

• 0 - 括弧括住數量和貨幣符號。

• 1 - 符號字串在數量和貨幣符號之前。

• 2 - 符號字串會遵循數量和貨幣符號。

• 3 - 符號字串緊接在貨幣符號之前。

• 4 - 符號字串緊接在貨幣符號後面。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

常式	必要的標頭
localeconv	<locale.h>

如需相容性詳細資訊，請參閱相容性。

程式庫

所有版本的 C 執行階段程式庫。

另請參閱

地區設定
setlocale
strcoll 函數
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l