std::lconv

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (C++11)

格式化庫 (C++20)

空終止序列工具

位元組字串

多位元組字串

寬字串

原生數值轉換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文字編碼標識

text_encoding (C++26)

 

本地化庫

區域設定和刻面 (Locales and facets)   區域設定 has_facet use_facet locale 刻面類別 (Facet category) 基類 (base classes) ctype_base codecvt_base messages_base time_base money_base ctype 刻面 ctype ctype<char> ctype_byname codecvt codecvt_byname 數字刻面 (numeric facets) num_get num_put numpunct numpunct_byname collate 刻面 collate collate_byname 時間刻面 (time facets) time_get time_put time_get_byname time_put_byname

貨幣刻面 (monetary facets) money_get money_put moneypunct moneypunct_byname messages 刻面 messages messages_byname 字元分類與轉換 字元分類 isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph 字元轉換 toupper    tolower 字串和流轉換 wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode 轉換刻面 codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C 庫區域設定 LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

定義於標頭檔案 <clocale>
struct lconv;

類 std::lconv 包含由 C 區域設定定義的數字和貨幣格式化規則。此結構的物件可以透過 std::localeconv 獲取。std::lconv 的成員是 char 型別和 char* 型別的值。除了 decimal_point 之外，每個 char* 成員都可能指向一個空字元（即一個空的 C 字串）。char 型別的成員都是非負數，如果當前 C 區域設定中沒有相應的值，則任何一個都可能是 CHAR_MAX。

成員物件

非貨幣數字格式引數

char* decimal_point	用作小數點的字元 (公有成員物件)
char* thousands_sep	用於分隔小數點前數字組的字元 (公有成員物件)
char* grouping	一個字串，其元素表示數字組的大小 (公有成員物件)

貨幣數字格式引數

char* mon_decimal_point	用作小數點的字元 (公有成員物件)
char* mon_thousands_sep	用於分隔小數點前數字組的字元 (公有成員物件)
char* mon_grouping	一個字串，其元素表示數字組的大小 (公有成員物件)
char* positive_sign	用於表示非負貨幣數量的字串 (公有成員物件)
char* negative_sign	用於表示負貨幣數量的字串 (公有成員物件)

本地貨幣數字格式引數

char* currency_symbol	當前 C 區域設定中用於貨幣的符號 (公有成員物件)
char frac_digits	貨幣數量中顯示的小數點後的位數 (公有成員物件)
char p_cs_precedes	如果 currency_symbol 放在非負值之前為 1，如果放在之後則為 ​0​ (公有成員物件)
char n_cs_precedes	如果 currency_symbol 放在負值之前為 1，如果放在之後則為 ​0​ (公有成員物件)
char p_sep_by_space	指示 currency_symbol、positive_sign 和非負貨幣值之間的分隔 (公有成員物件)
char n_sep_by_space	指示 currency_symbol、negative_sign 和負貨幣值之間的分隔 (公有成員物件)
char p_sign_posn	指示 positive_sign 在非負貨幣值中的位置 (公有成員物件)
char n_sign_posn	指示 negative_sign 在負貨幣值中的位置 (公有成員物件)

國際貨幣數字格式引數

char* int_curr_symbol	當前 C 區域設定中用作國際貨幣名稱的字串 (公有成員物件)
char int_frac_digits	國際貨幣數量中顯示的小數點後的位數 (公有成員物件)
char int_p_cs_precedes (C++11)	如果 int_curr_symbol 放在非負國際貨幣值之前為 1，如果放在之後則為 ​0​ (公有成員物件)
char int_n_cs_precedes (C++11)	如果 int_curr_symbol 放在負國際貨幣值之前為 1，如果放在之後則為 ​0​ (公有成員物件)
char int_p_sep_by_space (C++11)	指示 int_curr_symbol、positive_sign 和非負國際貨幣值之間的分隔 (公有成員物件)
char int_n_sep_by_space (C++11)	指示 int_curr_symbol、negative_sign 和負國際貨幣值之間的分隔 (公有成員物件)
char int_p_sign_posn (C++11)	指示 positive_sign 在非負國際貨幣值中的位置 (公有成員物件)
char int_n_sign_posn (C++11)	指示 negative_sign 在負國際貨幣值中的位置 (公有成員物件)

由 grouping 和 mon_grouping 指向的 C 字串的字元根據其數字值進行解釋。當遇到終止的 '\0' 時，最後一個值被假定為在剩餘數字中重複。如果遇到 CHAR_MAX，則不再對數字進行分組。典型的一次分組三個數字是 "\003"。

p_sep_by_space、n_sep_by_space、int_p_sep_by_space、int_n_sep_by_space 的值解釋如下：

0	貨幣符號和值之間沒有空格
1	符號緊貼貨幣符號，值由空格分隔
2	符號緊貼值。貨幣符號由空格分隔

p_sign_posn、n_sign_posn、int_p_sign_posn、int_n_sign_posn 的值解釋如下：

0	值和貨幣符號周圍使用括號表示符號
1	符號在值和貨幣符號之前
2	符號在值和貨幣符號之後
3	符號在貨幣符號之前
4	符號在貨幣符號之後

示例

執行此程式碼

#include <clocale>
#include <iostream>
 
int main()
{
    std::setlocale(LC_ALL, "ja_JP.UTF-8");
    std::lconv* lc = std::localeconv();
    std::cout << "Japanese currency symbol: " << lc->currency_symbol
              << '(' << lc->int_curr_symbol << ")\n";
}

輸出

Japanese currency symbol: ￥(JPY )

另請參閱

localeconv	查詢當前區域設定的數字和貨幣格式詳細資訊 (函式)
numpunct	定義數字標點規則 (類模板)
moneypunct	定義 std::money_get 和 std::money_put 使用的貨幣格式引數 (類模板)
C 文件 用於 lconv