std::wcscmp

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

Сравнивает две нуль-терминированные широкие строки лексикографически.

Знак результата — знак разницы между значениями первой пары широких символов, которые отличаются в сравниваемых строках.

Поведение не определено, если lhs или rhs не являются указателями на нуль-терминированные широкие строки.

Параметры

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

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

Ноль, если lhs и rhs равны при сравнении.

Положительное значение, если lhs следует за rhs в лексикографическом порядке.

Примечания

Эта функция не чувствительна к локали, в отличие от std::wcscoll, и порядок может не иметь смысла, когда используются символы из разных блоков Юникода или когда порядок кодовых единиц не соответствует порядку сортировки.

Пример

#include <algorithm>
#include <cwchar>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<const wchar_t*> leaders{L"Ленин", L"Сталин", L"Маленков",
        L"Хрущёв", L"Брежнев", L"Андропов", L"Черненко", L"Горбачёв"};
 
    std::ranges::sort(leaders, [](auto leaderLHS, auto leaderRHS)
    {
        return std::wcscmp(leaderLHS, leaderRHS) < 0;
    });
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    for (auto leader : leaders)
        std::wcout << leader << '\n';
}

Андропов
Брежнев
Горбачёв
Ленин
Маленков
Сталин
Хрущёв
Черненко

См. также