std::wcscoll

 

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)

 

Null-terminierte breite Zeichenketten

Funktionen
Zeichenklassifizierung
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit wctype	iswblank (C++11) iswctype iswcntrl iswgraph iswspace iswprint iswpunct
Zeichenmanipulation
towlower towupper	towctrans wctrans
Konvertierungen in numerische Formate
wcstolwcstoll (C++11)   wcstofwcstodwcstold (C++11)(C++11)	wcstoulwcstoull (C++11) wcstoimaxwcstouimax (C++11)(C++11)
Stringmanipulation
wcslen wcscmp wcscoll wcsncmp wcschr wcsrchr	wcspbrk wcsspn wcscspn wcsstr wcstok
Stringuntersuchung
wcscpy wcsncpy wcsxfrm	wcscat wcsncat
Array-Manipulation
wmemcpy wmemmove wmemcmp	wmemchr wmemset
Typen wctrans_t wctype_t wint_t	Makros WCHAR_MIN WCHAR_MAX WEOF

 

Definiert in Header <cwchar>
int wcscoll( const wchar_t* lhs, const wchar_t* rhs );

Vergleicht zwei nullterminierte Wide-Strings gemäß dem zuletzt von std::setlocale installierten Locale, wie in der Kategorie LC_COLLATE definiert.

Parameter

lhs, rhs

-

Zeiger auf die zu vergleichenden nullterminierten Breitzeichenketten

Rückgabewert

Negativer Wert, wenn lhs kleiner ist als (vorangestellt) rhs.

​0​, wenn lhs gleich rhs ist.

Positiver Wert, wenn lhs größer ist als (nachfolgend) rhs.

Hinweise

Die Kollationsreihenfolge ist die Wörterbuchreihenfolge: Die Position des Buchstabens im nationalen Alphabet (seine Äquivalenzklasse) hat eine höhere Priorität als Groß-/Kleinschreibung oder Variante. Innerhalb einer Äquivalenzklasse werden Kleinbuchstaben vor ihren Großbuchstaben-Entsprechungen sortiert, und eine lokalespezifische Reihenfolge kann für Zeichen mit diakritischen Zeichen gelten. In einigen Locales werden Zeichengruppen als einzelne Kollationseinheiten 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 <clocale>
#include <iostream>
 
void try_compare(const wchar_t* p1, const wchar_t* p2)
{
    if (std::wcscoll(p1, p2) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "cs_CZ.utf8");
    std::wcout << "In the Czech locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"år", L"ängel");
 
    std::setlocale(LC_COLLATE, "sv_SE.utf8");
    std::wcout << "In the Swedish locale: ";
    try_compare(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)
do_compare [virtuell]	vergleicht zwei Zeichenketten anhand der Sortierregeln dieses Facets (virtual protected member function of std::collate<CharT>)
wcsxfrm	transformiert eine breite Zeichenkette so, dass wcscmp dasselbe Ergebnis wie wcscoll liefert (Funktion)
C-Dokumentation für wcscoll