QByteArrayMatcher Class
La classe QByteArrayMatcher contient une séquence d'octets qui peuvent être rapidement mis en correspondance dans un tableau d'octets. Plus d'informations...
| 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 pour les 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 avez une séquence d'octets que vous voulez comparer à plusieurs reprises à des tableaux d'octets (peut-être dans une boucle), ou lorsque vous voulez rechercher la même séquence d'octets plusieurs fois dans le même tableau d'octets. L'utilisation d'un objet matcher et de indexIn() est plus rapide que la mise en correspondance d'un simple QByteArray avec QByteArray::indexOf() si la mise en correspondance est répétée. Cette classe n'offre aucun avantage si vous effectuez des correspondances ponctuelles dans un tableau d'octets.
Créez le QByteArrayMatcher avec le QByteArray que vous souhaitez rechercher. Appelez ensuite indexIn() sur le QByteArray que vous souhaitez rechercher.
Voir également QByteArray et QStringMatcher.
Documentation des fonctions membres
QByteArrayMatcher::QByteArrayMatcher()
Construit un matcheur de tableau d'octets vide qui ne correspondra à rien. Appelez setPattern() pour lui donner un motif à faire correspondre.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)
Construit un matcheur de tableau d'octets qui recherche pattern. Appelez indexIn() pour effectuer une recherche.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const char *pattern, qsizetype length = -1)
Construit un matcheur de tableau d'octets à partir de pattern. pattern a la valeur donnée length. Appelez indexIn() pour effectuer une recherche.
Remarque : les données auxquelles pattern fait référence doivent rester valides pendant l'utilisation de cet objet.
[explicit, since 6.3] QByteArrayMatcher::QByteArrayMatcher(QByteArrayView pattern)
Construit un matcheur de tableau d'octets qui recherche pattern. Appelez indexIn() pour effectuer une recherche.
Remarque : les données auxquelles pattern fait référence doivent rester valides pendant l'utilisation de cet objet.
Il s'agit d'une fonction surchargée.
Cette fonction a été introduite dans Qt 6.3.
QByteArrayMatcher::QByteArrayMatcher(const QByteArrayMatcher &other)
Copie le matcheur de tableaux d'octets other dans ce matcheur de tableaux d'octets.
[noexcept] QByteArrayMatcher::~QByteArrayMatcher()
Détruit le comparateur de tableaux d'octets.
qsizetype QByteArrayMatcher::indexIn(const char *str, qsizetype len, qsizetype from = 0) const
Recherche dans la chaîne de caractères str, de longueur len, à 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 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.
[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 dans l'appel le plus récent à setPattern(). Renvoie la position à laquelle pattern() correspond 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 de tableau d'octets que ce matcheur de tableau d'octets va rechercher.
Voir aussi setPattern().
void QByteArrayMatcher::setPattern(const QByteArray &pattern)
Définit le tableau d'octets que ce comparateur de tableaux d'octets recherchera à pattern.
Voir aussi pattern() et indexIn().
QByteArrayMatcher &QByteArrayMatcher::operator=(const QByteArrayMatcher &other)
Attribue le matcheur de tableaux d'octets other à ce matcheur 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.
