strxfrm

Преобразует байтовую строку с нулевым завершителем, на которую указывает src , в форму, определяемую реализацией, таким образом, что сравнение двух преобразованных строк с помощью strcmp дает тот же результат, что и сравнение исходных строк с помощью strcoll в текущей локали C.

Первые count символов преобразованной строки записываются в назначение, включая завершающий нулевой символ, и возвращается длина полной преобразованной строки, исключая завершающий нулевой символ.

Поведение не определено, если массив dest недостаточно велик. Поведение не определено, если dest и src перекрываются.

Если count равен ​ 0 ​ , тогда dest может быть нулевым указателем.

Примечания

Правильная длина буфера, которая может принять всю преобразованную строку, равна 1 + strxfrm ( NULL , src, 0 )

Эта функция используется при выполнении множественных сравнений, зависящих от локали, с использованием одной и той же строки или набора строк, поскольку более эффективно применять strxfrm для преобразования всех строк только один раз, а затем сравнивать преобразованные строки с помощью strcmp .

Параметры

Возвращаемое значение

Длина преобразованной строки, не включая завершающий нулевой символ.

Пример

#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

Ссылки

Смотрите также