std::collate<CharT>::compare, std::collate<CharT>::do_compare

 

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

 

std::collate

Memberfunktionen

collate::collate

collate::~collate

collate::comparecollate::do_compare

collate::transformcollate::do_transform

collate::hashcollate::do_hash

 

Definiert in Header <locale>
public: int compare( const CharT* low1, const CharT* high1,              const CharT* low2, const CharT* high2 ) const;	(1)
protected: virtual int do_compare( const CharT* low1, const CharT* high1,                         const CharT* low2, const CharT* high2 ) const;	(2)

1) Öffentliche Memberfunktion, ruft die geschützte virtuelle Memberfunktion do_compare der am weitesten abgeleiteten Klasse auf.

2) Vergleicht die Zeichensequenz [low1, high1) mit der Zeichensequenz [low2, high2) unter Verwendung der Sortierregeln dieser Locale und gibt 1 zurück, wenn die erste Zeichenkette der zweiten folgt, -1, wenn die erste Zeichenkette der zweiten vorausgeht, und null, wenn die beiden Zeichenketten äquivalent sind.

Parameter

low1	-	Zeiger auf das erste Zeichen der ersten Zeichenkette
high1	-	Zeiger auf das Ende der ersten Zeichenkette (exklusiv)
low2	-	Zeiger auf das erste Zeichen der zweiten Zeichenkette
high2	-	Zeiger auf das Ende der zweiten Zeichenkette (exklusiv)

Rückgabewert

1, wenn die erste Zeichenkette größer als die zweite ist (d. h. in der Sortierreihenfolge der zweiten folgt), -1, wenn die erste Zeichenkette kleiner als die zweite ist (in der Sortierreihenfolge der zweiten vorausgeht), null, wenn die beiden Zeichenketten äquivalent sind.

Hinweise

Wenn kein Drei-Wege-Vergleich erforderlich ist (z. B. bei der Angabe eines Compare-Arguments für Standardalgorithmen wie std::sort), kann std::locale::operator() geeigneter sein.

Die Sortierreihenfolge ist die Wörterbuchreihenfolge: Die Position des Buchstabens im nationalen Alphabet (seine *Äquivalenzklasse*) hat eine höhere Priorität als seine Groß- und Kleinschreibung oder Varianten. Innerhalb einer Äquivalenzklasse werden Kleinbuchstaben vor ihren Großbuchstaben-Entsprechungen sortiert, und die locale-spezifische Reihenfolge kann für Zeichen mit Diakritika gelten. In einigen Locales werden Zeichengruppen als einzelne *Sortiereinheiten* verglichen. Zum Beispiel folgt "ch" im Tschechischen auf "h" und geht "i" voraus, und "dzs" im Ungarischen folgt auf "dz" und geht "g" voraus.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <locale>
#include <string>
 
template<typename CharT>
void try_compare(const std::locale& l, const CharT* p1, const CharT* p2)
{
    auto& f = std::use_facet<std::collate<CharT>>(l);
 
    std::basic_string<CharT> s1(p1), s2(p2);
    if (f.compare(&s1[0], &s1[0] + s1.size(),
                  &s2[0], &s2[0] + s2.size()) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
 
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), "hrnec", "chrt");
    std::wcout << "In the Czech locale: ";
    try_compare(std::locale("cs_CZ.utf8"), "hrnec", "chrt");
 
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), L"år", L"ängel");
    std::wcout << "In the Swedish locale: ";
    try_compare(std::locale("sv_SE.utf8"), L"år", L"ängel");
}

Ausgabe

In the American locale: chrt before hrnec
In the Czech locale: hrnec before chrt
In the American locale: ängel before år
In the Swedish locale: år before ängel

Siehe auch

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)