QStringMatcher Class
La clase `QStringMatcher` contiene una secuencia de caracteres que se pueden buscar rápidamente en una cadena Unicode. Más información...
| Encabezado: | #include <QStringMatcher> |
| 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
- QStringMatcher forma parte de las clases para datos de cadena.
Funciones públicas
| QStringMatcher() | |
| QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive) | |
| QStringMatcher(const QStringMatcher &other) | |
| ~QStringMatcher() | |
| Qt::CaseSensitivity | caseSensitivity() const |
| qsizetype | indexIn(QStringView str, qsizetype from = 0) const |
| qsizetype | indexIn(const QString &str, qsizetype from = 0) const |
| qsizetype | indexIn(const QChar *str, qsizetype length, qsizetype from = 0) const |
| QString | pattern() const |
(since 6.7) QStringView | patternView() const |
| void | setCaseSensitivity(Qt::CaseSensitivity cs) |
| void | setPattern(const QString &pattern) |
| QStringMatcher & | operator=(const QStringMatcher &other) |
Descripción detallada
Esta clase resulta útil cuando se dispone de una secuencia de « QChar» que se desea comparar repetidamente con determinadas cadenas (quizás en un bucle), o cuando se desea buscar la misma secuencia de caracteres varias veces en la misma cadena. El uso de un objeto «matcher» y « indexIn()» es más rápido que comparar una « QString » simple con « QString::indexOf()» si se realizan comparaciones repetidas. Esta clase no ofrece ninguna ventaja si solo vas a realizar comparaciones puntuales de cadenas.
Crea el QStringMatcher con el QString que quieras buscar. A continuación, llama a indexIn() sobre el QString que quieras buscar.
Véase también « QString », « QByteArrayMatcher » y « QRegularExpression ».
Documentación de funciones de miembro
[constexpr noexcept default] QStringMatcher::QStringMatcher()
Crea un comparador de cadenas vacío que no coincidirá con nada. Llama a setPattern() para proporcionarle un patrón con el que realizar la comparación.
QStringMatcher::QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crea un comparador de cadenas que buscará « pattern », distinguiendo entre mayúsculas y minúsculas: « cs ».
Llama a ` indexIn()` para realizar una búsqueda.
[explicit] QStringMatcher::QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crea un comparador de cadenas que buscará « pattern », distinguiendo entre mayúsculas y minúsculas: « cs ».
Llama a ` indexIn()` para realizar una búsqueda.
QStringMatcher::QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Crea un comparador de cadenas que buscará el patrón indicado en ` uc `, con el ` length ` proporcionado y respetando las mayúsculas y minúsculas según se especifica en ` cs`.
QStringMatcher::QStringMatcher(const QStringMatcher &other)
Copia el comparador de cadenas « other » en este comparador de cadenas.
[noexcept] QStringMatcher::~QStringMatcher()
Elimina el comparador de cadenas.
Qt::CaseSensitivity QStringMatcher::caseSensitivity() const
Devuelve la configuración de distinción entre mayúsculas y minúsculas de este comparador de cadenas.
Véase también setCaseSensitivity().
qsizetype QStringMatcher::indexIn(QStringView str, qsizetype from = 0) const
Busca la cadena « str » a partir de la posición de carácter « from » (por defecto 0, es decir, desde el primer carácter), la cadena « 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.
Véase también setPattern() y setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QString &str, qsizetype from = 0) const
Busca la cadena « str » a partir de la posición de carácter from (por defecto 0, es decir, desde el primer carácter), la cadena « 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.
Véase también setPattern() y setCaseSensitivity().
qsizetype QStringMatcher::indexIn(const QChar *str, qsizetype length, qsizetype from = 0) const
Busca la cadena que comienza en str (de longitud length) a partir de la posición del carácter from (por defecto 0, es decir, desde el primer carácter), la cadena 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.
Véase también setPattern() y setCaseSensitivity().
QString QStringMatcher::pattern() const
Devuelve el patrón de cadena que buscará este comparador de cadenas.
Véase también ` setPattern()`.
[noexcept, since 6.7] QStringView QStringMatcher::patternView() const
Devuelve una vista de cadena del patrón que buscará este comparador de cadenas.
Esta función se introdujo en Qt 6.7.
Véase también ` setPattern()`.
void QStringMatcher::setCaseSensitivity(Qt::CaseSensitivity cs)
Establece la configuración de distinción entre mayúsculas y minúsculas de este comparador de cadenas en « cs ».
Véase también caseSensitivity(), setPattern() y indexIn().
void QStringMatcher::setPattern(const QString &pattern)
Establece la cadena que este comparador de cadenas buscará en pattern.
Véase también pattern(), setCaseSensitivity() y indexIn().
QStringMatcher &QStringMatcher::operator=(const QStringMatcher &other)
Asigna el comparador de cadenas « other » a este comparador de cadenas.
© 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.