QByteArrayMatcher Class
La clase `QByteArrayMatcher` contiene una secuencia de bytes que se puede comparar rápidamente con una matriz de bytes. Más información...
| Encabezado: | #include <QByteArrayMatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QByteArrayMatcher forma parte de las clases para datos de cadena.
Funciones públicas
| 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) |
Descripción detallada
Esta clase resulta útil cuando se dispone de una secuencia de bytes que se desea comparar repetidamente con algunas matrices de bytes (quizá en un bucle), o cuando se desea buscar la misma secuencia de bytes varias veces en la misma matriz de bytes. El uso de un objeto comparador y de la función ` indexIn()` es más rápido que comparar un ` QByteArray ` simple con ` QByteArray::indexOf()` si se realizan comparaciones repetidas. Esta clase no ofrece ninguna ventaja si solo vas a realizar comparaciones puntuales en matrices de bytes.
Crea el objeto `QByteArrayMatcher` con el ` QByteArray ` que deseas buscar. A continuación, llama a ` indexIn()` sobre el ` QByteArray ` que deseas buscar.
Véase también QByteArray y QStringMatcher.
Documentación de funciones de miembro
QByteArrayMatcher::QByteArrayMatcher()
Crea un comparador de matriz de bytes vacía que no coincidirá con nada. Llama a ` setPattern()` para proporcionarle un patrón con el que realizar la comparación.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)
Crea un comparador de matrices de bytes que buscará « pattern ». Llama a indexIn() para realizar una búsqueda.
[explicit] QByteArrayMatcher::QByteArrayMatcher(const char *pattern, qsizetype length = -1)
Crea un comparador de matrices de bytes a partir de pattern. pattern tiene el length indicado. Llama a indexIn() para realizar una búsqueda.
Nota: los datos a los que hace referencia pattern deben seguir siendo válidos mientras se utilice este objeto.
[explicit, since 6.3] QByteArrayMatcher::QByteArrayMatcher(QByteArrayView pattern)
Crea un comparador de matriz de bytes que buscará pattern. Llama a indexIn() para realizar una búsqueda.
Nota: los datos a los que hace referencia pattern deben seguir siendo válidos mientras se utilice este objeto.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.3.
QByteArrayMatcher::QByteArrayMatcher(const QByteArrayMatcher &other)
Copia el comparador de matrices de bytes « other » en este comparador de matrices de bytes.
[noexcept] QByteArrayMatcher::~QByteArrayMatcher()
Destruye el comparador de matrices de bytes.
qsizetype QByteArrayMatcher::indexIn(const char *str, qsizetype len, qsizetype from = 0) const
Busca la cadena de caracteres « str », que tiene una longitud de « len », a partir de la posición de byte « from » (por defecto 0, es decir, desde el primer byte), el array de bytes « pattern()» que se haya establecido en el constructor o en la última llamada a « setPattern()». Devuelve la posición en la que « pattern()» coincidió en « str », o -1 si no se encontró ninguna coincidencia.
[since 6.3] qsizetype QByteArrayMatcher::indexIn(QByteArrayView data, qsizetype from = 0) const
Busca en la matriz de bytes data, a partir de la posición de byte from (por defecto 0, es decir, desde el primer byte), la matriz de bytes pattern() que se estableció en el constructor o en la última llamada a setPattern(). Devuelve la posición en la que pattern() coincidió en data, o -1 si no se encontró ninguna coincidencia.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.3.
QByteArray QByteArrayMatcher::pattern() const
Devuelve el patrón de matriz de bytes que este comparador de matrices de bytes buscará.
Véase también setPattern().
void QByteArrayMatcher::setPattern(const QByteArray &pattern)
Establece la matriz de bytes en la que este comparador de matrices de bytes realizará la búsqueda en pattern.
Véase también pattern() y indexIn().
QByteArrayMatcher &QByteArrayMatcher::operator=(const QByteArrayMatcher &other)
Asigna el comparador de matrices de bytes « other » a este comparador de matrices de bytes.
© 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.