En esta página

QCollator Class

La clase QCollator compara cadenas de caracteres según un algoritmo de ordenación localizado. Más información...

Encabezado: #include <QCollator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QCollator

CategoríaTipos comparables
igualdadQCollator

Funciones públicas

QCollator()
QCollator(const QLocale &locale)
QCollator(const QCollator &other)
QCollator(QCollator &&other)
~QCollator()
Qt::CaseSensitivity caseSensitivity() const
int compare(QStringView s1, QStringView s2) const
int compare(const QString &s1, const QString &s2) const
int compare(const QChar *s1, qsizetype len1, const QChar *s2, qsizetype len2) const
bool ignorePunctuation() const
QLocale locale() const
bool numericMode() const
void setCaseSensitivity(Qt::CaseSensitivity cs)
void setIgnorePunctuation(bool on)
void setLocale(const QLocale &locale)
void setNumericMode(bool on)
QCollatorSortKey sortKey(const QString &string) const
void swap(QCollator &other)
bool operator()(QStringView s1, QStringView s2) const
bool operator()(const QString &s1, const QString &s2) const
QCollator &operator=(QCollator &&other)
QCollator &operator=(const QCollator &other)

Miembros públicos estáticos

(since 6.3) int defaultCompare(QStringView s1, QStringView s2)
(since 6.3) QCollatorSortKey defaultSortKey(QStringView key)
(since 6.12) bool operator!=(const QCollator &lhs, const QCollator &rhs)
(since 6.12) bool operator==(const QCollator &lhs, const QCollator &rhs)

Descripción detallada

QCollator se inicializa con un objeto ` QLocale`. A continuación, se puede utilizar para comparar y ordenar cadenas utilizando el orden adecuado para esa configuración regional.

Un objeto QCollator puede utilizarse junto con algoritmos de ordenación basados en plantillas, como std::sort(), para ordenar una lista con entradas de « QString ».

QStringList sortedStrings(QStringList seq)
{
    QCollator order;
    std::sort(seq.begin(), seq.end(), order);
    return seq;
}

Además de la configuración regional, se pueden establecer varios indicadores opcionales que influyen en el resultado de la colación.

Implementación alternativa de POSIX

En sistemas Unix, Qt se compila normalmente para utilizar ICU (excepto en macOS, donde Qt utiliza por defecto una API equivalente de Apple). Sin embargo, si ICU no estaba disponible en el momento de la compilación o se desactivó explícitamente, Qt utilizará un backend de reserva que utiliza únicamente la API de POSIX. Este backend tiene varias limitaciones:

  • Solo se admiten las configuraciones regionales « QLocale::c » () y « QLocale::system » (). Consulta los manuales de POSIX y de la biblioteca estándar de C para obtener más información sobre el encabezado « <locale.h> » y la configuración regional del sistema.
  • caseSensitivity() no es compatible: solo se puede realizar una colación que distinga entre mayúsculas y minúsculas.
  • numericMode() y ignorePunctuation() no son compatibles.

El uso de cualquiera de las opciones no admitidas provocará que se muestre una advertencia en la salida de la aplicación.

Documentación de las funciones miembro

QCollator::QCollator()

Crea un objeto QCollator utilizando la configuración de clasificación de la configuración regional predeterminada.

La configuración regional del sistema, cuando se utiliza como configuración regional predeterminada, puede tener una configuración regional de clasificación distinta de sí misma (por ejemplo, en Unix, si LC_COLLATE está configurado de forma diferente a LANG en el entorno). Todas las demás configuraciones regionales utilizan su propia configuración regional de clasificación.

Véase también setLocale(), QLocale::collation() y QLocale::setDefault().

[explicit] QCollator::QCollator(const QLocale &locale)

Crea un objeto `QCollator` utilizando el ` locale` indicado.

Véase también setLocale().

QCollator::QCollator(const QCollator &other)

Crea una copia de other.

[noexcept] QCollator::QCollator(QCollator &&other)

Constructor de traslado. Traslada el contenido de other a este collator.

Nota: El objeto del que se ha realizado la migración, other, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

[noexcept] QCollator::~QCollator()

Elimina este clasificador.

Qt::CaseSensitivity QCollator::caseSensitivity() const

Devuelve si el clasificador distingue entre mayúsculas y minúsculas.

Por defecto, distingue entre mayúsculas y minúsculas hasta que se configure.

Nota: En la configuración regional C, cuando se distingue entre mayúsculas y minúsculas, todas las letras minúsculas se ordenan después de todas las mayúsculas, mientras que en la mayoría de las configuraciones regionales cada letra minúscula se ordena inmediatamente antes o inmediatamente después de su equivalente en mayúscula. Por lo tanto, «Zap» se ordena antes que «ape» en la configuración regional C, pero después en la mayoría de las demás.

Véase también setCaseSensitivity().

int QCollator::compare(QStringView s1, QStringView s2) const

Compara s1 con s2.

Devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2 y cero si son iguales.

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

Esta es una función sobrecargada.

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

Compara s1 con s2. len1 y len2 especifican las longitudes de las matrices QChar a las que apuntan s1 y s2.

Devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

Nota: En las versiones de Qt anteriores a la 6.4, los argumentos de longitud eran de tipo int, no de qsizetype.

Esta es una función sobrecargada.

[static, since 6.3] int QCollator::defaultCompare(QStringView s1, QStringView s2)

Compara las cadenas « s1 » y « s2 », devolviendo su orden de clasificación. Esta función realiza la misma operación que « compare()» sobre un objeto « QCollator » construido de forma predeterminada.

Esta función se introdujo en Qt 6.3.

Véase también compare() y defaultSortKey().

[static, since 6.3] QCollatorSortKey QCollator::defaultSortKey(QStringView key)

Devuelve la clave de ordenación de la cadena « key ». Esta función realiza la misma operación que « sortKey()» sobre un objeto « QCollator » construido de forma predeterminada.

Esta función se introdujo en Qt 6.3.

Véase también sortKey() y defaultCompare().

bool QCollator::ignorePunctuation() const

Devuelve si se ignoran los signos de puntuación y los símbolos al ordenar.

Cuando se establece en « true », las cadenas se comparan como si se hubieran eliminado todos los signos de puntuación y símbolos de cada cadena.

Véase también setIgnorePunctuation().

QLocale QCollator::locale() const

Devuelve la configuración regional del clasificador.

A menos que se especifique en el constructor o llamando a setLocale(), se utiliza la configuración de colación predeterminada del sistema.

Véanse también setLocale() y QLocale::collation().

bool QCollator::numericMode() const

Devuelve « true » si la ordenación numérica está habilitada; en caso contrario, devuelve « false ».

Cuando true, los números se reconocen como tales y se ordenan en orden aritmético; por ejemplo, 100 viene después de 99. Cuando false, los números se ordenan en orden léxico, de modo que 100 viene antes de 99 (porque el 1 viene antes del 9). Por defecto, esta opción está desactivada.

Véase también setNumericMode().

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

Establece la distinción entre mayúsculas y minúsculas del clasificador en « cs ».

Véase también caseSensitivity().

void QCollator::setIgnorePunctuation(bool on)

Ignora la puntuación y los símbolos si on es true; los tiene en cuenta si false.

Véase también ignorePunctuation().

void QCollator::setLocale(const QLocale &locale)

Establece la configuración regional del clasificador en locale.

Véase también locale().

void QCollator::setNumericMode(bool on)

Activa el modo de ordenación numérica cuando « on » está establecido en « true ».

Véase también ` numericMode()`.

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

Devuelve una clave de ordenación para ` string`.

La creación de la clave de ordenación suele ser algo más lenta que utilizar directamente los métodos de ` compare()`. Sin embargo, si la cadena se compara repetidamente (por ejemplo, al ordenar una lista completa de cadenas), suele ser más rápido crear las claves de ordenación para cada cadena y, a continuación, ordenar utilizando dichas claves.

Nota: No es compatible con la configuración regional C (también conocida como POSIX) en Darwin.

[noexcept] void QCollator::swap(QCollator &other)

Cambia este clasificador por other. Esta operación es muy rápida y nunca falla.

bool QCollator::operator()(QStringView s1, QStringView s2) const

Se puede utilizar un « QCollator » como función de comparación de un algoritmo de ordenación. Devuelve « true » si « s1 » se ordena antes que « s2 »; en caso contrario, devuelve « false ».

Véase también compare().

bool QCollator::operator()(const QString &s1, const QString &s2) const

Esta es una función sobrecargada.

[noexcept] QCollator &QCollator::operator=(QCollator &&other)

La operación «move-assigns» asigna other a esta instancia de QCollator.

Nota: El objeto del que se ha realizado el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

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

Asigna « other » a este clasificador.

No miembros relacionados

[noexcept, since 6.12] bool operator!=(const QCollator &lhs, const QCollator &rhs)

[noexcept, since 6.12] bool operator==(const QCollator &lhs, const QCollator &rhs)

Devuelve « true » si lhs y rhs utilizan las mismas opciones de configuración regional y de ordenación; en caso contrario, devuelve « false ».

Estas funciones se introdujeron en Qt 6.12.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.