Класс QCollator

Класс QCollator сравнивает строки в соответствии с локализованным алгоритмом сортировки. Подробнее...

Этот класс был введён в Qt 5.2.

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

QCollator инициализируется с помощью QLocale и необязательной стратегии сортировки. Она пытается инициализировать сортировщик указанными значениями. Затем сортировщик может использоваться для сравнения и сортировки строк в зависимости от локали.

Объект QCollator может использоваться вместе с алгоритмами сортировки на основе шаблонов, такими как std::sort, для сортировки списка QStrings.

Помимо локали и стратегии сортировки, можно установить несколько необязательных флагов, которые влияют на результат сортировки.

Документация по функциям-членам

QCollator::QCollator(QCollator &&other)

Конструктор перемещения. Перемещает данные из other в этот сортировщик.

Обратите внимание, что перемещённый QCollator может быть только уничтожен или присвоен. Действие вызова других функций, кроме деструктора или одного из операторов присваивания, не определено.

QCollator::QCollator(const QCollator &other)

Создаёт копию other.

QCollator::QCollator(const QLocale &locale = QLocale())

Конструирует QCollator из locale. Если locale не указана, используется локаль по умолчанию системы.

См. также setLocale().

QCollator &QCollator::operator=(QCollator &&other)

Присваивание перемещением из other в этот сортировщик.

Обратите внимание, что перемещённый QCollator может быть только уничтожен или присвоен. Действие вызова других функций, кроме деструктора или одного из операторов присваивания, не определено.

QCollator &QCollator::operator=(const QCollator &other)

Присваивает other этому сортировщику.

QCollator::~QCollator()

Уничтожает сортировщик.

Qt::CaseSensitivity QCollator::caseSensitivity() const

Возвращает чувствительность к регистру сортировщика.

См. также setCaseSensitivity().

int QCollator::compare(const QString &s1, const QString &s2) const

Сравнивает s1 с s2. Возвращает целое число меньше, равно или больше нуля в зависимости от того, является ли s1 меньше, равно или больше s2.

int QCollator::compare(const QStringRef &s1, const QStringRef &s2) const

Это перегруженная функция.

Сравнивает s1 с s2. Возвращает целое число меньше, равно или больше нуля в зависимости от того, является ли s1 меньше, равно или больше s2.

int QCollator::compare(const QChar *s1, int len1, const QChar *s2, int len2) const

Это перегруженная функция.

Сравнивает s1 с s2. len1 и len2 задают длину массивов QChar, на которые указывают s1 и s2 соответственно.

Возвращает целое число меньше, равно или больше нуля в зависимости от того, является ли s1 меньше, равно или больше s2.

bool QCollator::ignorePunctuation() const

Возвращает значение true, если знаки препинания и символы игнорируются при определении порядка сортировки.

См. также setIgnorePunctuation().

QLocale QCollator::locale() const

Возвращает локаль сортировщика.

См. также setLocale().

bool QCollator::numericMode() const

Возвращает true, если включена числовая сортировка, иначе false.

См. также setNumericMode().

void QCollator::setCaseSensitivity(Qt::CaseSensitivity sensitivity)

Устанавливает чувствительность к регистру сортировщика.

См. также caseSensitivity().

void QCollator::setIgnorePunctuation(bool on)

Если on установлено в true, знаки препинания и символы игнорируются при определении порядка сортировки.

По умолчанию зависит от локали.

Примечание: Этот метод в настоящее время не поддерживается, если Qt сконфигурирован так, чтобы не использовать ICU в Linux.

См. также ignorePunctuation().

void QCollator::setLocale(const QLocale &locale)

Устанавливает локаль сортировщика на locale.

См. также locale().

void QCollator::setNumericMode(bool on)

Включает числовой режим сортировки, когда on установлено в true.

Это позволит правильно сортировать числовые цифры, так что, например, 100 будет сортироваться после 99.

По умолчанию этот режим выключен.

См. также numericMode().

QCollatorSortKey QCollator::sortKey(const QString &string) const

Возвращает sortKey для string.

Создание sortKey обычно несколько медленнее, чем непосредственное использование методов compare(). Но если строка сравнивается многократно (например, при сортировке всего списка строк), то обычно быстрее создать sortKey для каждой строки, а затем отсортировать по ключам.

Примечание: Не поддерживается с локалью C (также известной как POSIX) на Darwin.

void QCollator::swap(QCollator &other)

Меняет местами этот сортировщик с other. Эта функция очень быстрая и никогда не терпит неудачу.