QByteArrayMatcher Class
La classe `QByteArrayMatcher` contient une séquence d'octets qui peut être rapidement mise en correspondance avec un tableau d'octets. En savoir plus...
| En-tête : | #include <QByteArrayMatcher> |
| 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
- QByteArrayMatcher fait partie des classes dédiées aux données de type chaîne de caractères.
Fonctions publiques
| QByteArrayMatcher() | |
| QByteArrayMatcher(const QByteArray &pattern) | |
| QByteArrayMatcher(const char *pattern, qsizetype length = -1) | |
(since 6.3) | QByteArrayMatcher(QByteArrayView pattern) |
| QByteArrayMatcher(const QByteArrayMatcher &other) | |
| ~QByteArrayMatcher() | |
| qsizetype | indexIn(const char *str, qsizetype len, qsizetype from = 0) const |
(since 6.3) qsizetype | indexIn(QByteArrayView data, qsizetype from = 0) const |
| QByteArray | pattern() const |
| void | setPattern(const QByteArray &pattern) |
| QByteArrayMatcher & | operator=(const QByteArrayMatcher &other) |
Description détaillée
Cette classe est utile lorsque vous disposez d’une séquence d’octets que vous souhaitez comparer de manière répétée à des tableaux d’octets (par exemple dans une boucle), ou lorsque vous souhaitez rechercher plusieurs fois la même séquence d’octets dans un même tableau d’octets. L’utilisation d’un objet « matcher » et de la méthode ` indexIn()` est plus rapide que la comparaison d’un objet ` QByteArray ` avec la méthode ` QByteArray::indexOf()` en cas de comparaisons répétées. Cette classe ne présente aucun avantage si vous effectuez des comparaisons ponctuelles sur des tableaux d'octets.
Créez l'objet `QByteArrayMatcher` avec la ` QByteArray ` que vous souhaitez rechercher. Appelez ensuite la méthode ` indexIn()` sur le ` QByteArray ` que vous souhaitez analyser.
Voir également QByteArray et QStringMatcher.
Documentation sur les fonctions membres
QByteArrayMatcher::QByteArrayMatcher()
Crée un comparateur de tableau d'octets vide qui ne correspondra à rien. Appelez la méthode setPattern() pour lui fournir un motif à comparer.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)
Crée un comparateur de tableau d'octets qui recherchera les chaînes « pattern ». Appelez la méthode indexIn() pour effectuer une recherche.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const char *pattern, qsizetype length = -1)
Crée un comparateur de tableaux d'octets à partir de pattern. pattern contient l'length spécifiée. Appelez indexIn() pour effectuer une recherche.
Remarque : les données auxquelles pattern fait référence doivent rester valides tant que cet objet est utilisé.
[explicit, since 6.3] QByteArrayMatcher::QByteArrayMatcher(QByteArrayView pattern)
Crée un comparateur de tableau d'octets qui recherchera pattern. Appelez indexIn() pour effectuer une recherche.
Remarque : les données auxquelles fait référence pattern doivent rester valides tant que cet objet est utilisé.
Il s'agit d'une fonction surchargée.
Cette fonction a été introduite dans Qt 6.3.
QByteArrayMatcher::QByteArrayMatcher(const QByteArrayMatcher &other)
Copie le comparateur de tableaux d'octets « other » vers ce comparateur de tableaux d'octets.
[noexcept] QByteArrayMatcher::~QByteArrayMatcher()
Supprime le comparateur de tableaux d'octets.
qsizetype QByteArrayMatcher::indexIn(const char *str, qsizetype len, qsizetype from = 0) const
Recherche la chaîne de caractères str, d'une longueur de len, à partir de la position d'octet from (par défaut 0, c'est-à-dire à partir du premier octet), pour trouver le tableau d'octets pattern() défini dans le constructeur ou lors du dernier appel à setPattern(). Renvoie la position à laquelle pattern() a été trouvé dans str, ou -1 si aucune correspondance n'a été trouvée.
[since 6.3] qsizetype QByteArrayMatcher::indexIn(QByteArrayView data, qsizetype from = 0) const
Recherche dans le tableau d'octets data, à partir de la position d'octet from (par défaut 0, c'est-à-dire à partir du premier octet), le tableau d'octets pattern() qui a été défini dans le constructeur ou lors du dernier appel à setPattern(). Renvoie la position à laquelle pattern() a été trouvé dans data, ou -1 si aucune correspondance n'a été trouvée.
Il s'agit d'une fonction surchargée.
Cette fonction a été introduite dans Qt 6.3.
QByteArray QByteArrayMatcher::pattern() const
Renvoie le motif sous forme de tableau d'octets que ce comparateur de tableaux d'octets va rechercher.
Voir aussi setPattern().
void QByteArrayMatcher::setPattern(const QByteArray &pattern)
Définit le tableau d'octets dans lequel ce comparateur de tableaux d'octets effectuera sa recherche sur pattern.
Voir également pattern() et indexIn().
QByteArrayMatcher &QByteArrayMatcher::operator=(const QByteArrayMatcher &other)
Attribue le comparateur de tableaux d'octets « other » à ce comparateur de tableaux d'octets.
© 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.
