std::collate_byname

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

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

Textkodierungserkennung

text_encoding (C++26)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets 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-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

Definiert in Header <locale>
template< class CharT > class collate_byname : public std::collate<CharT>;

std::collate_byname ist eine Facette von std::collate, die lokalisierungsspezifische Kollation (Vergleich) und Hashing von Zeichenketten kapselt. Genau wie std::collate kann sie in std::regex eingebettet und mittels std::locale::operator() direkt auf alle Standardalgorithmen angewendet werden, die eine Vergleichsprädikat für Zeichenketten erwarten.

Spezialisierungen

Die Standardbibliothek garantiert die Bereitstellung der folgenden Spezialisierungen

Definiert in Header <locale>
std::collate_byname<char>	lokalisierungsspezifische Kollation von Multibyte-Zeichenketten
std::collate_byname<wchar_t>	lokalisierungsspezifische Kollation von Wide-Zeichenketten

Member-Funktionen

(Konstruktor)	erzeugt eine neue collate_byname Facette (public member function)
(Destruktor)	zerstört eine collate_byname Facette (protected member function)

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 );		(seit C++11)

Erstellt eine neue std::collate_byname Facette für eine Lokalisierung mit dem Namen name.

refs wird für die Ressourcenverwaltung verwendet: Wenn refs = 0 ist, zerstört die Implementierung die Facettenklasse, wenn das letzte std::locale-Objekt, das sie hält, zerstört wird. Andernfalls wird das Objekt nicht zerstört.

Parameter

name	-	der Name der Locale
refs	-	die Anzahl der Referenzen, die auf die Facettenklasse verweisen

std::collate_byname::~collate_byname

protected: ~collate_byname();

Zerstört die Facettenklasse.

Von std::collate geerbt

Verschachtelte Typen

Typ	Definition
char_type	CharT
string_type	std::basic_string<CharT>

Datenmember

Mitglied	Beschreibung
std::locale::id id [static]	die Kennung des Facets

Memberfunktionen

compare	ruft do_compare auf (public member function of std::collate<CharT>)
transform	ruft do_transform auf (public member function of std::collate<CharT>)
hash	ruft do_hash auf (public member function of std::collate<CharT>)

Geschützte Memberfunktionen

do_compare [virtuell]	vergleicht zwei Zeichenketten anhand der Sortierregeln dieses Facets (virtual protected member function of std::collate<CharT>)
do_transform [virtuell]	transformiert eine Zeichenkette, damit die Sortierung durch einen Vergleich ersetzt werden kann (virtual protected member function of std::collate<CharT>)
do_hash [virtuell]	generiert einen ganzzahligen Hashwert unter Verwendung der Kollationsregeln dieser Facette (virtual protected member function of std::collate<CharT>)

Hinweise

Die Kollationsreihenfolge ist die alphabetische Reihenfolge: Die Position des Buchstabens im nationalen Alphabet (seine Äquivalenzklasse) hat eine höhere Priorität als Groß- und Kleinschreibung oder Varianten. Innerhalb einer Äquivalenzklasse werden Kleinbuchstaben vor ihren entsprechenden Großbuchstaben sortiert und die lokalisierungsspezifische Reihenfolge kann für Zeichen mit diakritischen Zeichen gelten. In einigen Lokalisierungen werden Zeichengruppen als einzelne Kollationseinheiten verglichen. Zum Beispiel folgt "ch" im Tschechischen auf "h" und steht vor "i", und "dzs" im Ungarischen folgt auf "dz" und steht vor "g".

Siehe auch

collate	definiert lexikographische Vergleiche und Hashing von Zeichenketten (Klassentemplate)
strcoll	vergleicht zwei Strings gemäß der aktuellen Locale (Funktion)
wcscoll	vergleicht zwei breite Zeichenketten gemäß der aktuellen Locale (Funktion)
operator()	Vergleicht lexikografisch zwei Zeichenketten mit der collate-Facet dieses Locales. (public member function of std::locale)