QCollator Class

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

Documentation des fonctions membres

QCollator::QCollator()

Crée un objet `QCollator` en utilisant la locale de classement de la locale par défaut.

La locale système, lorsqu’elle est utilisée comme locale par défaut, peut avoir une locale de classement différente d’elle-même (par exemple sous Unix, si LC_COLLATE est défini différemment de LANG dans l’environnement). Toutes les autres locales ont pour locale de classement leur propre locale.

Voir également setLocale(), QLocale::collation() et QLocale::setDefault().

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

Crée un objet QCollator à partir de l'locale fourni.

Voir aussi setLocale().

QCollator::QCollator(const QCollator &other)

Crée une copie de other.

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

Constructeur de déplacement. Déplace les données de other vers ce collateur.

[noexcept] QCollator::~QCollator()

Supprime ce trieur.

Qt::CaseSensitivity QCollator::caseSensitivity() const

Renvoie si le collateur tient compte de la casse.

Par défaut, le tri est sensible à la casse jusqu’à ce que cette option soit définie.

Voir également setCaseSensitivity().

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

Compare s1 à s2.

Renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

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

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

Compare s1 à s2. len1 et len2 spécifient les longueurs des tableaux QChar pointés par s1 et s2.

Renvoie un entier négatif si s1 est inférieur à s2, un entier positif s’il est supérieur à s2, et zéro s’ils sont égaux.

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

Compare les chaînes « s1 » et « s2 », et renvoie leur ordre de tri. Cette fonction effectue la même opération que la méthode compare() sur un objet QCollator construit par défaut.

Cette fonction a été introduite dans Qt 6.3.

Voir également compare() et defaultSortKey().

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

Renvoie la clé de tri de la chaîne « key ». Cette fonction effectue la même opération que la méthode ` sortKey()` sur un objet ` QCollator ` construit par défaut.

Cette fonction a été introduite dans Qt 6.3.

Voir également sortKey() et defaultCompare().

bool QCollator::ignorePunctuation() const

Indique si la ponctuation et les symboles sont ignorés lors du classement.

Lorsque la valeur est true, les chaînes sont comparées comme si tous les signes de ponctuation et tous les symboles avaient été supprimés de chaque chaîne.

Voir aussi setIgnorePunctuation().

QLocale QCollator::locale() const

Renvoie les paramètres régionaux du collateur.

À moins qu'elle ne soit fournie au constructeur ou via l'appel à la fonction setLocale(), c'est la locale de collation par défaut du système qui est utilisée.

Voir également setLocale() et QLocale::collation().

bool QCollator::numericMode() const

Renvoie « true » si le tri numérique est activé, « false » dans le cas contraire.

Lorsque true, les chiffres sont reconnus comme des nombres et triés par ordre arithmétique ; par exemple, 100 vient après 99. Lorsque false, les nombres sont triés par ordre lexical, de sorte que 100 vient avant 99 (car 1 précède 9). Par défaut, cette option est désactivée.

Voir également setNumericMode().

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

Définit la sensibilité à la casse du collateur sur « cs ».

Voir également caseSensitivity().

void QCollator::setIgnorePunctuation(bool on)

Ignore la ponctuation et les symboles si on est true; en tient compte si false.

Voir également ignorePunctuation().

void QCollator::setLocale(const QLocale &locale)

Définit les paramètres régionaux du collateur sur « locale ».

Voir également la fonction locale().

void QCollator::setNumericMode(bool on)

Active le mode de tri numérique lorsque la valeur de « on » est « true ».

Voir également numericMode().

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

Renvoie une clé de tri pour ` string`.

La création de la clé de tri est généralement un peu plus lente que l’utilisation directe des méthodes ` compare()`. Cependant, si la chaîne est comparée à plusieurs reprises (par exemple, lors du tri d’une liste entière de chaînes), il est généralement plus rapide de créer les clés de tri pour chaque chaîne, puis d’effectuer le tri à l’aide de ces clés.

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

Permet d'échanger ce collateur contre other. Cette opération est très rapide et ne rencontre jamais d'échec.

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

Une fonction « QCollator » peut être utilisée comme fonction de comparaison dans un algorithme de tri. Elle renvoie true si s1 est trié avant s2, sinon false.

Voir également compare().

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

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

Cette opération attribue la valeur de other à cette instance de QCollator.

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

Attribue la valeur « other » à ce collateur.