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 |
- Lista de todos los miembros, incluidos los heredados
- QCollator forma parte de las clases para datos de cadena y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QCollator
| Categoría | Tipos comparables |
|---|---|
| igualdad | QCollator |
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) |
Elementos no miembros relacionados
(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.