共用方式為


localeconv

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

語法

struct lconv *localeconv( void );

傳回值

localeconv 會傳回 類型 struct lconv之填入物件的指標。 物件中包含的值會從線程本機記憶體的地區設定複製,並可由後續呼叫 localeconv覆寫。 對這個物件中值所做的變更不會修改地區設定。 setlocale使用 categoryLC_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