Namespaces
Variants

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

From cppreference.net
C++
Text processing library
Localization library
std::collate
Определено в заголовочном файле <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)
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

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

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