wcsxfrm

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte breite Zeichenketten

Funktionen Zeichenklassifizierung iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95)   iswblank (C99) iswctype (C95) iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) wctype (C95) Zeichenmanipulation towlower (C95) towupper (C95) wctrans (C95) towctrans (C95) Konvertierungen in numerische Formate wcstolwcstoll (C95)(C99) wcstofwcstodwcstold (C99)(C95)(C99) wcstoulwcstoull (C95)(C99) wcstoimaxwcstoumax (C99)(C99)     Stringmanipulation wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcsxfrm (C95) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11)

Stringuntersuchung wcslenwcsnlen_s (C95)(C11) wcsstr (C95) wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11) Array-Manipulation wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)   wmemcmp (C95) wmemchr (C95) wmemset (C95) Typen wchar_t wint_t (C95) wctrans_t wctype_t (C95)(C95) Makros WCHAR_MIN WCHAR_MAX (C95)(C95) WEOF (C95)

 

Definiert in Header <wchar.h>
size_t wcsxfrm( wchar_t* dest, const wchar_t* src, size_t count );		(bis C99) (seit C95)
size_t wcsxfrm( wchar_t* restrict dest, const wchar_t* restrict src, size_t count );		(seit C99)

Transformiert die nullterminierte Wide-String, auf die von src gezeigt wird, in die implementierungsdefinierte Form, so dass der Vergleich zweier transformierter Strings mit wcscmp das gleiche Ergebnis liefert wie der Vergleich der ursprünglichen Strings mit wcscoll in der aktuellen C-Locale.

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

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

Anmerkungen

Die korrekte Länge des Puffers, der den gesamten transformierten String aufnehmen kann, ist 1+wcsxfrm(NULL, src, 0)

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

Parameter

dest	-	Zeiger auf das erste Element eines Wide-Nullterminierten Strings, in den der transformierte String geschrieben werden soll
src	-	Zeiger auf den nullterminierten Wide-Character-String, der transformiert werden soll
zählt	-	maximale Anzahl der auszugebenden Zeichen

Rückgabewert

Die Länge des transformierten Wide-Strings, ohne das abschließende Nullzeichen.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <wchar.h>
#include <locale.h>
 
int main(void)
{
    setlocale(LC_ALL, "sv_SE.utf8");
 
    const wchar_t *in1 = L"\u00e5r";
    wchar_t out1[1+wcsxfrm(NULL, in1, 0)];
    wcsxfrm(out1, in1, sizeof out1/sizeof *out1);
 
    const wchar_t *in2 = L"\u00e4ngel";
    wchar_t out2[1+wcsxfrm(NULL, in2, 0)];
    wcsxfrm(out2, in2, sizeof out2/sizeof *out2);
 
    printf("In the Swedish locale: ");
    if(wcscmp(out1, out2) < 0)
         printf("%ls before %ls\n", in1, in2);
    else
         printf("%ls before %ls\n", in2, in1);
 
    printf("In lexicographical comparison: ");
    if(wcscmp(in1, in2) < 0)
         printf("%ls before %ls\n", in1, in2);
    else
         printf("%ls before %ls\n", in2, in1);
}

Ausgabe

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

Referenzen

• C11-Standard (ISO/IEC 9899:2011)

• 7.29.4.4.4 The wcsxfrm function (S. 434-435)

• C99-Standard (ISO/IEC 9899:1999)

• 7.24.4.4.4 The wcsxfrm function (S. 380-381)

Siehe auch

strcoll	vergleicht zwei Strings gemäß der aktuellen Locale (Funktion)
wcscoll (C95)	vergleicht zwei breite Zeichenketten gemäß der aktuellen Locale (Funktion)
wcscmp (C95)	vergleicht zwei breite Zeichenketten (Funktion)
strxfrm	transformiert einen String so, dass strcmp dasselbe Ergebnis wie strcoll liefert (Funktion)
C++ Dokumentation für wcsxfrm