std::wcsxfrm

 

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>
std::size_t wcsxfrm( wchar_t* dest, const wchar_t* src, std::size_t count );

Transformiert den Null-terminierten Breitzeichenstring, auf den von src gezeigt wird, in die implementierungsdefinierte Form, so dass der Vergleich zweier transformierter Strings mit std::wcscmp dasselbe Ergebnis liefert wie der Vergleich der ursprünglichen Strings mit std::wcscoll, in der aktuellen C-Locale.

Die ersten count Zeichen des transformierten Strings werden in das Ziel geschrieben, einschließlich des abschließenden Nullzeichens. Die Länge des vollständigen transformierten Strings, exklusive des abschließenden Nullzeichens, wird zurückgegeben.

Wenn count ​0​ ist, darf dest ein Nullzeiger sein.

Hinweise

Die korrekte Pufferlänge, die den gesamten transformierten String aufnehmen kann, ist 1 + std::wcsxfrm(nullptr, src, 0).

Diese Funktion wird verwendet, wenn mehrere Locale-abhängige Vergleiche mit demselben Breitzeichenstring oder einer Menge von Breitzeichenstrings durchgeführt werden, da es effizienter ist, std::wcsxfrm zu verwenden, um alle Strings nur einmal zu transformieren und anschließend die transformierten Breitzeichenstrings mit std::wcscmp zu vergleichen.

Parameter

dest	-	Zeiger auf das erste Element eines Null-terminierten Breitzeichenstrings, in den der transformierte String geschrieben wird
src	-	Zeiger auf den Null-terminierten Breitzeichenstring, der transformiert werden soll
zählt	-	maximale Anzahl auszugebender Zeichen

Rückgabewert

Die Länge des transformierten Breitzeichenstrings, exklusive des abschließenden Nullzeichens.

Beispiel

Führen Sie diesen Code aus

#include <cwchar>
#include <iostream>
 
int main()
{
    std::setlocale(LC_ALL, "sv_SE.utf8");
 
    std::wstring in1 = L"\u00e5r";
    std::wstring out1(1 + std::wcsxfrm(nullptr, in1.c_str(), 0), L' ');
    std::wstring in2 = L"\u00e4ngel";
    std::wstring out2(1 + std::wcsxfrm(nullptr, in2.c_str(), 0), L' ');
 
    std::wcsxfrm(&out1[0], in1.c_str(), out1.size());
    std::wcsxfrm(&out2[0], in2.c_str(), out2.size());
 
    std::wcout << "In the Swedish locale: ";
    if (out1 < out2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
 
    std::wcout << "In lexicographical comparison: ";
    if (in1 < in2)
        std::wcout << in1 << " before " << in2 << '\n';
    else
        std::wcout << in2 << " before " << in1 << '\n';
 
}

Ausgabe

In the Swedish locale: år before ängel
In lexicographical comparison: ängel before år

Siehe auch

strxfrm	transformiert einen String so, dass strcmp das gleiche Ergebnis wie strcoll liefert (Funktion)
do_transform [virtuell]	transformiert eine Zeichenkette, damit die Sortierung durch einen Vergleich ersetzt werden kann (virtual protected member function of std::collate<CharT>)
wcscoll	vergleicht zwei breite Zeichenketten gemäß der aktuellen Locale (Funktion)
C-Dokumentation für wcsxfrm