QStringMatcher Class
La clase QStringMatcher contiene una secuencia de caracteres que pueden emparejarse rápidamente en una cadena Unicode. Más...
| Cabecera: | #include <QStringMatcher> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluyendo los heredados
- QStringMatcher es parte de 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 es útil cuando se tiene una secuencia de QChars que se desea comparar repetidamente con algunas cadenas (quizás en un bucle), o cuando se desea buscar la misma secuencia de caracteres varias veces en la misma cadena. Utilizar un objeto matcher y indexIn() es más rápido que comparar una cadena QString con QString::indexOf() si se producen comparaciones repetidas. Esta clase no ofrece ningún beneficio si estas haciendo coincidencias de cadena una sola vez.
Cree el QStringMatcher con el QString que desea buscar. Luego llame a indexIn() en el QString que desea buscar.
Ver también QString, QByteArrayMatcher, y QRegularExpression.
Documentación de las funciones miembro
[constexpr noexcept] QStringMatcher::QStringMatcher()
Construye un emparejador de cadenas vacío que no emparejará nada. Llama a setPattern() para darle un patrón con el que coincidir.
QStringMatcher::QStringMatcher(QStringView pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construye un emparejador de cadenas que buscará pattern, con distinción entre mayúsculas y minúsculas cs.
Llame a indexIn() para realizar una búsqueda.
[explicit] QStringMatcher::QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construye un emparejador de cadenas que buscará pattern, con distinción entre mayúsculas y minúsculas cs.
Llame a indexIn() para realizar una búsqueda.
QStringMatcher::QStringMatcher(const QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive)
Construye un emparejador de cadenas que buscará el patrón referido por uc con el length dado y la sensibilidad a mayúsculas y minúsculas especificada por cs.
QStringMatcher::QStringMatcher(const QStringMatcher &other)
Copia el comparador de cadenas other a este comparador de cadenas.
[noexcept] QStringMatcher::~QStringMatcher()
Destruye el comparador de cadenas.
Qt::CaseSensitivity QStringMatcher::caseSensitivity() const
Devuelve el ajuste de sensibilidad a mayúsculas/minúsculas para este comparador de cadenas.
Véase también setCaseSensitivity().
qsizetype QStringMatcher::indexIn(QStringView str, qsizetype from = 0) const
Busca en la cadena str desde la posición de carácter from (por defecto 0, es decir, desde el primer carácter), la cadena pattern() que se estableció en el constructor o en la llamada más reciente 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 en la cadena str desde la posición de carácter from (por defecto 0, es decir, desde el primer carácter), la cadena pattern() que se estableció en el constructor o en la llamada más reciente 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 en la cadena que comienza en str (de longitud length) desde la posición de carácter from (por defecto 0, es decir, desde el primer carácter), la cadena pattern() que se estableció en el constructor o en la llamada más reciente 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 emparejador 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 emparejador de cadenas.
Esta función se introdujo en Qt 6.7.
Véase también setPattern().
void QStringMatcher::setCaseSensitivity(Qt::CaseSensitivity cs)
Establece la sensibilidad a mayúsculas/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 buscará este comparador de cadenas 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.