QStaticByteArrayMatcher Class
template <size_t N> class QStaticByteArrayMatcherLa clase `QStaticByteArrayMatcher` es una versión en tiempo de compilación de ` QByteArrayMatcher`. Más...
| Encabezado: | #include <QStaticByteArrayMatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- QStaticByteArrayMatcher forma parte de las clases para datos de cadena.
Funciones públicas
| qsizetype | indexIn(const QByteArray &haystack, qsizetype from = 0) const |
| qsizetype | indexIn(const char *haystack, qsizetype hlen, qsizetype from = 0) const |
| QByteArray | pattern() const |
Elementos no miembros relacionados
| QStaticByteArrayMatcher<N> | qMakeStaticByteArrayMatcher(const char (&pattern)[N]) |
Descripción detallada
QStaticByteArrayMatcher<N> es una clase de plantilla en la que N es la longitud del patrón de la matriz de bytes que se va a buscar (incluido el terminador nulo para los literales de cadena). Esta clase resulta útil cuando se dispone de una secuencia de bytes que se desea comparar repetidamente con varias matrices de bytes (quizás en un bucle), o cuando se desea buscar la misma secuencia de bytes varias veces en la misma matriz de bytes. Utilizar un objeto «matcher» y ` indexIn()` es más rápido que comparar un ` QByteArray ` sin formato con ` QByteArray::indexOf()`, especialmente si se realizan comparaciones repetidas.
A diferencia de QByteArrayMatcher, esta clase calcula la representación interna en tiempo de compilación, por lo que puede resultar beneficiosa incluso si se realizan comparaciones puntuales en matrices de bytes.
Crea el `QStaticByteArrayMatcher` llamando a ` qMakeStaticByteArrayMatcher()`, pasándole el literal de cadena C que deseas buscar. Almacena el valor de retorno de esa función en una variable ` static const auto `, de modo que no tengas que pasar explícitamente el parámetro de plantilla ` N `:
static const auto matcher = qMakeStaticByteArrayMatcher("needle");A continuación, llama a ` indexIn()` sobre la variable ` QByteArray ` en la que deseas realizar la búsqueda, igual que con ` QByteArrayMatcher`.
Dado que esta clase está diseñada para realizar todos los cálculos por adelantado en tiempo de compilación, no ofrece un método setPattern().
Véase también ` QByteArrayMatcher ` y ` QStringMatcher`.
Documentación de las funciones miembro
[noexcept] qsizetype QStaticByteArrayMatcher::indexIn(const QByteArray &haystack, qsizetype from = 0) const
Busca la cadena de caracteres haystack, 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.
Devuelve la posición en la que se ha encontrado la coincidencia de pattern() en haystack, o -1 si no se ha encontrado ninguna coincidencia.
[noexcept] qsizetype QStaticByteArrayMatcher::indexIn(const char *haystack, qsizetype hlen, qsizetype from = 0) const
Busca la cadena de caracteres ` haystack`, que tiene una longitud de ` hlen`, a partir de la posición de byte ` from ` (por defecto 0, es decir, desde el primer byte), en busca de la matriz de bytes ` pattern()` que se estableció en el constructor.
Devuelve la posición en la que pattern() coincidió en haystack, o -1 si no se encontró ninguna coincidencia.
QByteArray QStaticByteArrayMatcher::pattern() const
Devuelve el patrón de matriz de bytes que este comparador de matrices de bytes buscará.
Véase también QByteArrayMatcher::setPattern().
Elementos no miembros relacionados
[constexpr noexcept] template <size_t N> QStaticByteArrayMatcher<N> qMakeStaticByteArrayMatcher(const char (&pattern)[N])
Devuelve un ` QStaticByteArrayMatcher ` con el ` N ` correcto, determinado automáticamente a partir del ` pattern ` pasado.
Para sacar el máximo partido a esta función, asigna el resultado a una variable de tipo « auto »:
static const auto matcher = qMakeStaticByteArrayMatcher("needle");© 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.