Класс QCollator

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

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

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

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

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

Класс QCollator сравнивает строки в соответствии с алгоритмом сортировки, локализованным для конкретной языковой среды.

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

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

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

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

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

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

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

QCollator::QCollator(const QCollator &other)

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

QCollator::QCollator(QCollator &&other)

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

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

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.

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

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

void QCollator::swap(QCollator &other)

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

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

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

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

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

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