QStringMatcher Class
La classe QStringMatcher contient une séquence de caractères pouvant être rapidement mise en correspondance dans une chaîne Unicode. En savoir plus...
| En-tête : | #include <QStringMatcher> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
- Liste de tous les membres, y compris les membres hérités
- QStringMatcher fait partie des classes dédiées aux données de type chaîne de caractères.
Fonctions publiques
| QStringMatcher() | |
| QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QStringMatcher &other) | |
| ~QStringMatcher() | |
| Qt::CaseSensitivity | caseSensitivity() const |
| qsizetype | indexIn(QStringView str, qsizetype from = 0) const |
| qsizetype | indexIn(const QString &str, qsizetype from = 0) const |
| qsizetype | indexIn(const QChar *str, qsizetype length, qsizetype from = 0) const |
| QString | pattern() const |
(since 6.7) QStringView | patternView() const |
| void | setCaseSensitivity(Qt::CaseSensitivity cs) |
| void | setPattern(const QString &pattern) |
| QStringMatcher & | operator=(const QStringMatcher &other) |
Description détaillée
Cette classe est utile lorsque vous disposez d’une séquence d’ QChars que vous souhaitez comparer de manière répétée à certaines chaînes de caractères (éventuellement dans une boucle), ou lorsque vous souhaitez rechercher plusieurs fois la même séquence de caractères dans une même chaîne. L’utilisation d’un objet « matcher » et de la méthode indexIn() est plus rapide que la comparaison d’un objet « QString » simple avec la méthode QString::indexOf() en cas de comparaisons répétées. Cette classe ne présente aucun avantage si vous effectuez des recherches ponctuelles sur des chaînes de caractères.
Créez le QStringMatcher avec l’ QString e que vous souhaitez rechercher. Appelez ensuite la méthode indexIn() sur l’ QString e que vous souhaitez analyser.
Voir également QString, QByteArrayMatcher et QRegularExpression.
Documentation sur les fonctions membres
[constexpr noexcept default] QStringMatcher::QStringMatcher()
Crée un comparateur de chaînes vide qui ne correspondra à rien. Appelez la fonction setPattern() pour lui fournir un motif à comparer.
QStringMatcher::QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crée un comparateur de chaînes qui recherchera « pattern », en tenant compte de la casse (« cs »).
Appelez ` indexIn()` pour effectuer une recherche.
[explicit] QStringMatcher::QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crée un comparateur de chaînes qui recherchera « pattern », en tenant compte de la casse (« cs »).
Appelez ` indexIn()` pour effectuer une recherche.
QStringMatcher::QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crée un comparateur de chaînes qui recherchera le motif indiqué par ` uc `, avec l'length spécifiée et en tenant compte de la sensibilité à la casse définie par ` cs`.
QStringMatcher::QStringMatcher(const QStringMatcher &other)
Copie le comparateur de chaînes « other » vers ce comparateur de chaînes.
[noexcept] QStringMatcher::~QStringMatcher()
Supprime le comparateur de chaînes.
Qt::CaseSensitivity QStringMatcher::caseSensitivity() const
Renvoie le paramètre de distinction entre majuscules et minuscules pour ce comparateur de chaînes.
Voir aussi : ` setCaseSensitivity()`.
qsizetype QStringMatcher::indexIn(QStringView str, qsizetype from = 0) const
Recherche la chaîne « str » à partir de la position from (par défaut 0, c'est-à-dire à partir du premier caractère), pour la chaîne « pattern » () qui a été définie dans le constructeur ou lors du dernier appel à la fonction « setPattern » (). Renvoie la position où la chaîne « pattern » () a été trouvée dans « str », ou -1 si aucune correspondance n'a été trouvée.
Voir également setPattern() et setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QString &str, qsizetype from = 0) const
Recherche la chaîne « str » à partir de la position from (par défaut 0, c'est-à-dire à partir du premier caractère), pour la chaîne « pattern » () définie dans le constructeur ou lors du dernier appel à la fonction « setPattern » (). Renvoie la position où la chaîne « pattern » () a été trouvée dans « str », ou -1 si aucune correspondance n'a été trouvée.
Voir également setPattern() et setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QChar *str, qsizetype length, qsizetype from = 0) const
Recherche la chaîne commençant à str (de longueur length) à partir de la position from (par défaut 0, c'est-à-dire à partir du premier caractère), pour la chaîne pattern() qui a été définie dans le constructeur ou lors du dernier appel à setPattern(). Renvoie la position à laquelle la chaîne pattern() a été trouvée dans str, ou -1 si aucune correspondance n'a été trouvée.
Voir également setPattern() et setCaseSensitivity().
QString QStringMatcher::pattern() const
Renvoie le motif de chaîne que ce comparateur de chaînes va rechercher.
Voir également la fonction ` setPattern()`.
[noexcept, since 6.7] QStringView QStringMatcher::patternView() const
Renvoie une vue de chaîne correspondant au motif que ce comparateur de chaînes va rechercher.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi setPattern().
void QStringMatcher::setCaseSensitivity(Qt::CaseSensitivity cs)
Définit le paramètre de sensibilité à la casse de ce comparateur de chaînes sur « cs ».
Voir également caseSensitivity(), setPattern() et indexIn().
void QStringMatcher::setPattern(const QString &pattern)
Définit la chaîne que ce comparateur de chaînes recherchera sur pattern.
Voir également pattern(), setCaseSensitivity() et indexIn().
QStringMatcher &QStringMatcher::operator=(const QStringMatcher &other)
Attribue le comparateur de chaînes « other » à ce comparateur de chaînes.
© 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.
