std::strxfrm

std::size_t strxfrm( char* dest, const char* src, std::size_t count );

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

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

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

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

Примечания

Правильная длина буфера, в который может поместиться вся преобразованная строка, равна 1 + std::strxfrm(nullptr, src, 0).

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

Параметры

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

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

Пример

#include <cassert>
#include <cstring>
#include <iomanip>
#include <iostream>
#include <string>

int main()
{
    char* loc = std::setlocale(LC_COLLATE, "cs_CZ.iso88592");
    assert(loc);

    std::string in1 = "hrnec";
    std::string out1(1 + std::strxfrm(nullptr, in1.c_str(), 0), ' ');
    std::string in2 = "chrt";
    std::string out2(1 + std::strxfrm(nullptr, in2.c_str(), 0), ' ');

    std::strxfrm(&out1[0], in1.c_str(), out1.size());
    std::strxfrm(&out2[0], in2.c_str(), out2.size());

    std::cout << "In the Czech locale: ";
    if (out1 < out2)
        std::cout << in1 << " before " << in2 << '\n';
    else
        std::cout << in2 << " before " << in1 << '\n';

    std::cout << "In lexicographical comparison: ";
    if (in1 < in2)
        std::cout << in1 << " before " << in2 << '\n';
    else
        std::cout << in2 << " before " << in1 << '\n';
}

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

См. также