std::collate<CharT>::compare, std::collate<CharT>::do_compare

Определено в заголовке <locale>

Определено в заголовке `<locale>`
public: int compare( const CharT* low1, const CharT* high1, const CharT* low2, const CharT* high2 ) const;	(1)
protected: virtual int do_compare( const CharT* low1, const CharT* high1, const CharT* low2, const CharT* high2 ) const;	(2)

public:
int compare( const CharT* low1, const CharT* high1,
             const CharT* low2, const CharT* high2 ) const;

(1)

protected:
virtual int do_compare( const CharT* low1, const CharT* high1,
                        const CharT* low2, const CharT* high2 ) const;

(2)

1) Публичный член-функция, вызывает защищённую виртуальную член-функцию do_compare самого производного класса.

2) Сравнивает последовательность символов [low1, high1) с последовательностью символов [low2, high2), используя правила сортировки текущей локали, и возвращает 1 если первая строка следует за второй, -1 если первая строка предшествует второй, ноль, если две строки эквивалентны.

Параметры

low1	-	указатель на первый символ первой строки
high1	-	указатель на позицию, следующую за концом первой строки
low2	-	указатель на первый символ второй строки
high2	-	указатель на позицию, следующую за концом второй строки

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

1 если первая строка больше второй (то есть следует за второй в порядке сортировки), -1 если первая строка меньше второй (предшествует второй в порядке сортировки), ноль, если две строки эквивалентны.

Примечания

Когда сравнение «тремя путями» не требуется (например, при передаче Compare аргумента стандартным алгоритмам, таким как std::sort), std::locale::operator() может быть более подходящим.

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

Пример

#include <iostream>
#include <locale>
#include <string>
 
template<typename CharT>
void try_compare(const std::locale& l, const CharT* p1, const CharT* p2)
{
    auto& f = std::use_facet<std::collate<CharT>>(l);
 
    std::basic_string<CharT> s1(p1), s2(p2);
    if (f.compare(&s1[0], &s1[0] + s1.size(),
                  &s2[0], &s2[0] + s2.size()) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
 
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), "hrnec", "chrt");
    std::wcout << "In the Czech locale: ";
    try_compare(std::locale("cs_CZ.utf8"), "hrnec", "chrt");
 
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), L"år", L"ängel");
    std::wcout << "In the Swedish locale: ";
    try_compare(std::locale("sv_SE.utf8"), 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

См. также

strcoll	сравнивает две строки в соответствии с текущей локалью (функция)
wcscoll	сравнивает две широкие строки в соответствии с текущей локалью (функция)
operator()	лексикографически сравнивает две строки, используя сортировочный объект этой локали (публичная член-функция объекта `std::locale`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/collate/compare