std::wcscoll

int wcscoll( const wchar_t* lhs, const wchar_t* rhs );

Сравнивает две строковые переменные широкого типа с нулевым окончанием в соответствии с локалью, установленной недавно std::setlocale, как определено категорией LC_COLLATE.

Параметры

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

Отрицательное значение, если lhs меньше (предшествует) rhs.

Нулевое значение, если lhs равно rhs.

Положительное значение, если lhs больше (следует за) rhs.

Примечания

Порядок сортировки — лексикографический: позиция буквы в национальном алфавите (ее класс эквивалентности) имеет более высокий приоритет, чем её регистр или варианты написания. В пределах класса эквивалентности строчные символы сортируются перед их заглавными эквивалентами, а также могут применяться правила сортировки, специфичные для локали, для символов с диакритическими знаками. В некоторых локалях группы символов сравниваются как единые единицы сортировки. Например, "ch" в чешском языке следует за "h" и предшествует "i", а "dzs" в венгерском языке следует за "dz" и предшествует "g".

Пример

#include <clocale>
#include <iostream>
 
void try_compare(const wchar_t* p1, const wchar_t* p2)
{
    if (std::wcscoll(p1, p2) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "cs_CZ.utf8");
    std::wcout << "In the Czech locale: ";
    try_compare(L"hrnec", L"chrt");
 
    std::setlocale(LC_COLLATE, "en_US.utf8");
    std::wcout << "In the American locale: ";
    try_compare(L"år", L"ängel");
 
    std::setlocale(LC_COLLATE, "sv_SE.utf8");
    std::wcout << "In the Swedish locale: ";
    try_compare(L"år", L"ängel");
}

In the American locale: chrt before hrnec
In the Czech locale: hrnec before chrt
In the American locale: ängel before år
In the Swedish locale: år before ängel

См. также