QStringMatcher Class
La classe QStringMatcher contient une séquence de caractères qui peuvent être rapidement mis en correspondance dans une chaîne Unicode. Plus d'informations...
| 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 pour les 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 de QChars que vous souhaitez comparer de manière répétée à certaines chaînes (peut-être dans une boucle), ou lorsque vous souhaitez rechercher la même séquence de caractères plusieurs fois dans la même chaîne. L'utilisation d'un objet matcher et de indexIn() est plus rapide que la mise en correspondance d'un simple QString avec QString::indexOf() si la mise en correspondance est répétée. Cette classe n'offre aucun avantage si vous effectuez des correspondances ponctuelles de chaînes de caractères.
Créez le QStringMatcher avec le QString que vous souhaitez rechercher. Appelez ensuite indexIn() sur le QString que vous souhaitez rechercher.
Voir également QString, QByteArrayMatcher, et QRegularExpression.
Documentation sur les fonctions membres
[constexpr noexcept] QStringMatcher::QStringMatcher()
Construit une chaîne de caractères vide qui ne correspond à rien. Appelez setPattern() pour lui donner un motif à faire correspondre.
QStringMatcher::QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construit un comparateur de chaînes de caractères qui recherche pattern, avec la sensibilité à la casse cs.
Appelez indexIn() pour effectuer une recherche.
[explicit] QStringMatcher::QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construit un comparateur de chaînes de caractères qui recherche pattern, avec la sensibilité à la casse cs.
Appelez indexIn() pour effectuer une recherche.
QStringMatcher::QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construit un analyseur de chaînes de caractères qui recherchera le motif mentionné par uc avec la valeur length et la sensibilité à la casse spécifiée par cs.
QStringMatcher::QStringMatcher(const QStringMatcher &other)
Copie le comparateur de chaînes other dans ce comparateur de chaînes.
[noexcept] QStringMatcher::~QStringMatcher()
Détruit l'analyseur de chaînes de caractères.
Qt::CaseSensitivity QStringMatcher::caseSensitivity() const
Renvoie le paramètre de sensibilité à la casse pour ce moteur de recherche de chaînes de caractères.
Voir aussi setCaseSensitivity().
qsizetype QStringMatcher::indexIn(QStringView str, qsizetype from = 0) const
Recherche dans la chaîne str à partir de la position de caractère from (par défaut 0, c'est-à-dire à partir du premier caractère), la chaîne pattern() qui a été définie dans le constructeur ou dans l'appel le plus récent à setPattern(). Renvoie la position à laquelle pattern() correspond dans str, ou -1 si aucune correspondance n'a été trouvée.
Voir aussi setPattern() et setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QString &str, qsizetype from = 0) const
Recherche dans la chaîne str à partir de la position de caractère from (par défaut 0, c'est-à-dire à partir du premier caractère), la chaîne pattern() qui a été définie dans le constructeur ou dans l'appel le plus récent à setPattern(). Renvoie la position à laquelle pattern() correspond dans str, ou -1 si aucune correspondance n'a été trouvée.
Voir aussi setPattern() et setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QChar *str, qsizetype length, qsizetype from = 0) const
Recherche dans la chaîne commençant à str (de longueur length) à partir de la position de caractère from (par défaut 0, c'est-à-dire à partir du premier caractère), la chaîne pattern() qui a été définie dans le constructeur ou dans l'appel le plus récent à setPattern(). Renvoie la position à laquelle pattern() correspond dans str, ou -1 si aucune correspondance n'a été trouvée.
Voir aussi setPattern() et setCaseSensitivity().
QString QStringMatcher::pattern() const
Renvoie le motif de la chaîne de caractères recherchée par ce filtre.
Voir aussi setPattern().
[noexcept, since 6.7] QStringView QStringMatcher::patternView() const
Renvoie une vue de la chaîne de caractères du motif recherché par cet outil de recherche de chaînes.
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 cet outil de recherche de chaînes à cs.
Voir aussi caseSensitivity(), setPattern(), et indexIn().
void QStringMatcher::setPattern(const QString &pattern)
Définit la chaîne recherchée par ce comparateur de chaînes à pattern.
Voir aussi pattern(), setCaseSensitivity() et indexIn().
QStringMatcher &QStringMatcher::operator=(const QStringMatcher &other)
Attribue l'outil de recherche de chaînes other à cet outil de recherche 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.