En esta página

QLatin1StringMatcher Class

Búsqueda optimizada de subcadenas en texto Latin-1. Más...

Encabezado: #include <QLatin1StringMatcher>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.5

Funciones públicas

QLatin1StringMatcher()
QLatin1StringMatcher(QLatin1StringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
~QLatin1StringMatcher()
Qt::CaseSensitivity caseSensitivity() const
qsizetype indexIn(QLatin1StringView haystack, qsizetype from = 0) const
(since 6.8) qsizetype indexIn(QStringView haystack, qsizetype from = 0) const
QLatin1StringView pattern() const
void setCaseSensitivity(Qt::CaseSensitivity cs)
void setPattern(QLatin1StringView pattern)

Descripción detallada

Un QLatin1StringMatcher puede buscar una cadena « QLatin1StringView » como subcadena de otra, ya sea ignorando las mayúsculas y minúsculas o teniéndolas en cuenta.

Esta clase resulta útil cuando se dispone de una cadena codificada en Latin-1 que se desea buscar repetidamente en algunas QLatin1StringViews (quizás en un bucle), o cuando se desea buscar todas sus instancias en una « QLatin1StringView » determinada. El uso de un objeto «matcher» y de la función « indexIn()» es más rápido que realizar la comparación de una cadena simple « QLatin1StringView » con « QLatin1StringView::indexOf()» si se llevan a cabo comparaciones repetidas. Esta clase no ofrece ninguna ventaja si se realizan comparaciones puntuales. La cadena que se va a buscar no debe destruirse ni modificarse antes de que se destruya el objeto «matcher», ya que este accede a la cadena al buscarla.

Crea un `QLatin1StringMatcher` para el ` QLatin1StringView ` que desees buscar y la distinción entre mayúsculas y minúsculas. A continuación, llama a ` indexIn()` con el ` QLatin1StringView ` en el que desees realizar la búsqueda.

Véase también « QLatin1StringView », « QStringMatcher » y « QByteArrayMatcher ».

Documentación de funciones de miembro

[noexcept] QLatin1StringMatcher::QLatin1StringMatcher()

Crea un comparador de cadenas Latin-1 vacío. Este comparador coincidirá con cualquier carácter en cada posición de cualquier cadena.

Véase también setPattern(), setCaseSensitivity() y indexIn().

[explicit noexcept] QLatin1StringMatcher::QLatin1StringMatcher(QLatin1StringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Crea un comparador de cadenas en Latin-1 que busca el pattern dado con la distinción entre mayúsculas y minúsculas cs especificada. El argumento pattern no debe destruirse antes que este objeto comparador. Llama a indexIn() para encontrar el pattern en el QLatin1StringView dado.

[noexcept] QLatin1StringMatcher::~QLatin1StringMatcher()

Elimina el comparador de cadenas Latin-1.

[noexcept] Qt::CaseSensitivity QLatin1StringMatcher::caseSensitivity() const

Devuelve si el comparador distingue entre mayúsculas y minúsculas.

Véase también setCaseSensitivity() y indexIn().

[noexcept] qsizetype QLatin1StringMatcher::indexIn(QLatin1StringView haystack, qsizetype from = 0) const

Busca el patrón en la dirección haystack, empezando por from.

Véase también caseSensitivity() y pattern().

[noexcept, since 6.8] qsizetype QLatin1StringMatcher::indexIn(QStringView haystack, qsizetype from = 0) const

Busca el patrón en el objeto ` haystack ` dado, comenzando en la posición de índice ` from`.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.8.

Véanse también caseSensitivity() y pattern().

[noexcept] QLatin1StringView QLatin1StringMatcher::pattern() const

Devuelve el patrón en Latin-1 que busca el comparador.

Véase también setPattern() y indexIn().

[noexcept] void QLatin1StringMatcher::setCaseSensitivity(Qt::CaseSensitivity cs)

Establece la distinción entre mayúsculas y minúsculas en cs.

Véanse también caseSensitivity() y indexIn().

[noexcept] void QLatin1StringMatcher::setPattern(QLatin1StringView pattern)

Establece el « pattern » que se va a buscar. La cadena a la que apunta « QLatin1StringView » no debe destruirse antes de que se destruya el comparador, a menos que se haya configurado previamente para que apunte a un « pattern » diferente con una vida útil más larga.

Véase también pattern() y indexIn().

© 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.