std::collate_byname

 

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

 

定義於標頭檔案 <locale>
template< class CharT > class collate_byname : public std::collate<CharT>;

std::collate_byname 是一個 std::collate 方面（facet），它封裝了特定於語言環境的字串整理（比較）和雜湊。與 std::collate 一樣，它可以被注入到 std::regex 中，並透過 std::locale::operator() 直接應用於所有期望字串比較謂詞的標準演算法。

特化

標準庫保證提供以下特化

定義於標頭檔案 <locale>
std::collate_byname<char>	多位元組字串的語言環境特定整理
std::collate_byname<wchar_t>	寬字串的語言環境特定整理

成員函式

(建構函式)	構造新的 collate_byname 方面（facet） (公有成員函式)
(解構函式)	銷燬 collate_byname 方面（facet） (受保護成員函式)

std::collate_byname::collate_byname

explicit collate_byname( const char* name, std::size_t refs = 0 );
explicit collate_byname( const std::string& name, std::size_t refs = 0 );		(C++11 起)

為具有 name 的語言環境構造一個新的 std::collate_byname 方面。

refs 用於資源管理：如果 refs == 0，則當持有它的最後一個 std::locale 物件被銷燬時，實現會銷燬該方面。否則，該物件不會被銷燬。

引數

name	-	區域設定的名稱
refs	-	連結到 facet 的引用計數

std::collate_byname::~collate_byname

protected: ~collate_byname();

銷燬 facet。

繼承自 std::collate

巢狀型別

型別	定義
char_type	CharT
string_type	std::basic_string<CharT>

資料成員

成員	描述
std::locale::id id [static]	facet 的識別符號

成員函式

compare	呼叫 do_compare (std::collate<CharT> 的公有成員函式)
transform	呼叫 do_transform (std::collate<CharT> 的公有成員函式)
hash	呼叫 do_hash (std::collate<CharT> 的公有成員函式)

受保護的成員函式

do_compare [虛擬函式]	使用此 facet 的排序規則比較兩個字串 (std::collate<CharT> 的虛保護成員函式)
do_transform [虛擬函式]	轉換字串，以便整理可以透過比較來替代 (std::collate<CharT> 的虛保護成員函式)
do_hash [虛擬函式]	使用此方面的整理規則生成整數雜湊值 (std::collate<CharT> 的虛保護成員函式)

注意

整理順序是字典順序：字母在國家字母表中的位置（其 *等價類*）比其大小寫或變體具有更高的優先順序。在等價類中，小寫字元排在大寫字元之前，並且特定於語言環境的順序可能適用於帶有變音符號的字元。在某些語言環境中，字元組作為一個 *整理單元* 進行比較。例如，捷克語中的 "ch" 在 "h" 之後，在 "i" 之前；匈牙利語中的 "dzs" 在 "dz" 之後，在 "g" 之前。

參閱

collate	定義字串的詞法比較和雜湊 (類模板)
strcoll	根據當前區域設定比較兩個字串 (函式)
wcscoll	根據當前語言環境比較兩個寬字串 (函式)
operator()	使用此區域設定的 collate facet 對兩個字串進行字典比較 (std::locale 的公有成員函式)