QStaticLatin1StringMatcher Class
template <Qt::CaseSensitivity CS, size_t N> class QStaticLatin1StringMatcherLa clase `QStaticLatin1StringMatcher` es una versión en tiempo de compilación de ` QLatin1StringMatcher`. Más información...
| Encabezado: | #include <QStaticLatin1StringMatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.7 |
- Lista de todos los miembros, incluidos los heredados
- QStaticLatin1StringMatcher forma parte de las clases para datos de cadena.
Funciones públicas
| qsizetype | indexIn(QLatin1StringView haystack, qsizetype from = 0) const |
| qsizetype | indexIn(QStringView haystack, qsizetype from = 0) const |
Elementos no miembros relacionados
(since 6.7) auto | qMakeStaticCaseInsensitiveLatin1StringMatcher(const char (&patternToMatch)[N]) |
(since 6.7) auto | qMakeStaticCaseSensitiveLatin1StringMatcher(const char (&patternToMatch)[N]) |
Descripción detallada
QStaticLatin1StringMatcher<CS, N> es una clase de plantilla en la que CS es el « Qt::CaseSensitivity » que se utilizará para la coincidencia y N es la longitud del patrón que se va a buscar (incluido el terminador nulo para los literales de cadena).
Esta clase resulta útil cuando el código necesita buscar de forma eficiente en cadenas Latin-1 una subcadena conocida en tiempo de compilación. Esto es habitual, por ejemplo, en los analizadores sintácticos. Utilizar el método indexIn() de un objeto comparador es más rápido que utilizar el método miembro indexOf() de la cadena en la que se realiza la búsqueda, especialmente cuando la cadena que se busca se va a buscar repetidamente o dentro de una cadena Latin-1 de gran tamaño que puede contener muchas coincidencias con prefijos de la subcadena que se busca.
A diferencia de ` QLatin1StringMatcher`, esta clase calcula la representación interna en tiempo de compilación, por lo que puede resultar beneficiosa incluso si solo se realizan búsquedas puntuales en cadenas Latin-1.
Crea el `QStaticLatin1StringMatcher` llamando a ` qMakeStaticCaseSensitiveLatin1StringMatcher()` o a ` qMakeStaticCaseInsensitiveLatin1StringMatcher()` y pasando la cadena Latin-1 que se va a buscar como un literal de cadena C. Almacena el valor devuelto por esa función en una variable ` static constexpr auto `, de modo que no sea necesario pasar explícitamente el parámetro de plantilla ` N `.
A continuación, llama a ` indexIn()` sobre el ` QLatin1StringView ` en el que quieras realizar la búsqueda, igual que con ` QLatin1StringMatcher`.
Dado que esta clase está diseñada para realizar todos los cálculos previos en tiempo de compilación, no ofrece los métodos setPattern() ni setCaseSensitivity().
Nota: Actualmente no es compatible con el sistema operativoINTEGRITY .
Véase también QLatin1StringMatcher, QStaticByteArrayMatcher y QByteArrayMatcher.
Documentación de las funciones de miembro
[constexpr noexcept] qsizetype QStaticLatin1StringMatcher::indexIn(QLatin1StringView haystack, qsizetype from = 0) const
[constexpr noexcept] qsizetype QStaticLatin1StringMatcher::indexIn(QStringView haystack, qsizetype from = 0) const
Busca en QLatin1StringView haystack , a partir de la posición de byte from (por defecto 0, es decir, desde el primer byte), el patrón QLatin1StringView pattern() que se haya establecido en el constructor. Se tiene en cuenta la distinción entre mayúsculas y minúsculas tal y como se haya establecido en el constructor.
Devuelve la posición en la que el patrón pattern() coincidió en haystack, o -1 si no se encontró ninguna coincidencia.
Elementos no miembros relacionados
[constexpr noexcept, since 6.7] template <size_t N> auto qMakeStaticCaseInsensitiveLatin1StringMatcher(const char (&patternToMatch)[N])
Devuelve un ` QStaticLatin1StringMatcher ` con el ` N ` correcto, determinado automáticamente a partir del ` patternToMatch ` pasado, y sin distinción entre mayúsculas y minúsculas.
Para sacar el máximo partido a esta función, asigna el resultado a una variable de tipo ` static constexpr auto `:
static constexpr auto matcher = qMakeStaticCaseInsensitiveLatin1StringMatcher("needle");Esta función se introdujo en Qt 6.7.
[constexpr noexcept, since 6.7] template <size_t N> auto qMakeStaticCaseSensitiveLatin1StringMatcher(const char (&patternToMatch)[N])
Devuelve un ` QStaticLatin1StringMatcher ` con el ` N ` correcto, determinado automáticamente a partir del ` patternToMatch ` pasado, y respetando las mayúsculas y minúsculas.
Para sacar el máximo partido a esta función, asigna el resultado a una variable de tipo ` static constexpr auto `:
static constexpr auto matcher = qMakeStaticCaseSensitiveLatin1StringMatcher("needle");Esta función se introdujo en Qt 6.7.
© 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.