strxfrm

Transformiert die nullterminierte Byte-Zeichenkette, auf die src zeigt, in die implementationsdefinierte Form, sodass der Vergleich zweier transformierter Zeichenketten mit strcmp das gleiche Ergebnis liefert wie der Vergleich der ursprünglichen Zeichenketten mit strcoll 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.

Das Verhalten ist undefiniert, wenn das dest -Array nicht groß genug ist. Das Verhalten ist undefiniert, wenn sich dest und src überlappen.

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

Hinweise

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

Diese Funktion wird verwendet, wenn mehrere gebietsschemaabhängige Vergleiche mit demselben String oder derselben Gruppe von Strings durchgeführt werden, da es effizienter ist, strxfrm zu verwenden, um alle Strings nur einmal zu transformieren und anschließend die transformierten Strings mit strcmp zu vergleichen.

Parameter

Rückgabewert

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

Beispiel

#include <stdio.h>
#include <string.h>
#include <locale.h>
int main(void)
{
    setlocale(LC_COLLATE, "cs_CZ.iso88592");
    const char *in1 = "hrnec";
    char out1[1+strxfrm(NULL, in1, 0)];
    strxfrm(out1, in1, sizeof out1);
    const char *in2 = "chrt";
    char out2[1+strxfrm(NULL, in2, 0)];
    strxfrm(out2, in2, sizeof out2);
    printf("In the Czech locale: ");
    if(strcmp(out1, out2) < 0)
         printf("%s before %s\n",in1, in2);
    else
         printf("%s before %s\n",in2, in1);
    printf("In lexicographical comparison: ");
    if(strcmp(in1, in2)<0)
         printf("%s before %s\n",in1, in2);
    else
         printf("%s before %s\n",in2, in1);
}

In the Czech locale: hrnec before chrt
In lexicographical comparison: chrt before hrnec

Referenzen

Siehe auch