QRegularExpressionMatch Class

Documentación de las funciones miembro

QRegularExpressionMatch::QRegularExpressionMatch()

Construye un objeto QRegularExpressionMatch válido y vacío. La expresión regular se establece a una construida por defecto; el tipo de coincidencia a QRegularExpression::NoMatch y las opciones de coincidencia a QRegularExpression::NoMatchOption.

El objeto no informará de ninguna coincidencia a través de las funciones miembro hasMatch() y hasPartialMatch().

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

Construye un resultado de coincidencia copiando el resultado del match dado.

Véase también operator=().

[constexpr noexcept, since 6.1] QRegularExpressionMatch::QRegularExpressionMatch(QRegularExpressionMatch &&match)

Construye una coincidencia moviendo el resultado desde la dirección match.

Tenga en cuenta que un QRegularExpressionMatch movido desde sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.

Esta función se introdujo en Qt 6.1.

Véase también operator=().

[noexcept] QRegularExpressionMatch::~QRegularExpressionMatch()

Destruye el resultado del partido.

QString QRegularExpressionMatch::captured(QAnyStringView name) const

Devuelve la subcadena capturada por el grupo de captura llamado name.

Si el grupo de captura llamado name no capturó una cadena, o si no existe un grupo de captura llamado name, devuelve un valor nulo QString.

Véase también capturedView(), capturedStart(), capturedEnd(), capturedLength(), y QString::isNull().

QString QRegularExpressionMatch::captured(int nth = 0) const

Devuelve la subcadena capturada por el grupo de captura nth.

Si el grupo de captura nth no capturó una cadena, o si no existe tal grupo de captura, devuelve un QString nulo.

Véase también capturedView(), lastCapturedIndex(), capturedStart(), capturedEnd(), capturedLength() y QString::isNull().

qsizetype QRegularExpressionMatch::capturedEnd(QAnyStringView name) const

Devuelve el desplazamiento dentro de la cadena de asunto inmediatamente después de la posición final de la subcadena capturada por el grupo de captura denominado name. Si el grupo de captura llamado name no capturó una cadena o no existe, devuelve -1.

Véase también capturedStart(), capturedLength(), y captured().

qsizetype QRegularExpressionMatch::capturedEnd(int nth = 0) const

Devuelve el desplazamiento dentro de la cadena de asunto inmediatamente después de la posición final de la subcadena capturada por el grupo de captura nth. Si el grupo de captura nth no capturó una cadena o no existe, devuelve -1.

Véase también capturedStart(), capturedLength() y captured().

qsizetype QRegularExpressionMatch::capturedLength(QAnyStringView name) const

Devuelve la longitud de la subcadena capturada por el grupo de captura denominado name.

Véase también capturedStart(), capturedEnd(), y captured().

qsizetype QRegularExpressionMatch::capturedLength(int nth = 0) const

Devuelve la longitud de la subcadena capturada por el grupo de captura nth.

Véase también capturedStart(), capturedEnd() y captured().

qsizetype QRegularExpressionMatch::capturedStart(QAnyStringView name) const

Devuelve el desplazamiento dentro de la cadena de asunto correspondiente a la posición inicial de la subcadena capturada por el grupo de captura denominado name. Si el grupo de captura llamado name no capturó una cadena o no existe, devuelve -1.

Véase también capturedEnd(), capturedLength(), y captured().

qsizetype QRegularExpressionMatch::capturedStart(int nth = 0) const

Devuelve el desplazamiento dentro de la cadena de asunto correspondiente a la posición inicial de la subcadena capturada por el grupo de captura nth. Si el grupo de captura nth no capturó una cadena o no existe, devuelve -1.

Véase también capturedEnd(), capturedLength() y captured().

QStringList QRegularExpressionMatch::capturedTexts() const

Devuelve una lista de todas las cadenas capturadas por los grupos de captura, en el orden en que los propios grupos aparecen en la cadena del patrón. La lista incluye el grupo de captura implícito número 0, que captura la subcadena coincidente con todo el patrón.

QStringView QRegularExpressionMatch::capturedView(QAnyStringView name) const

Devuelve una vista de la cadena capturada por el grupo de captura llamado name.

Si el grupo de captura llamado name no capturó una cadena, o si no existe un grupo de captura llamado name, devuelve un valor nulo QStringView.

Véase también captured(), capturedStart(), capturedEnd(), capturedLength(), y QStringView::isNull().

QStringView QRegularExpressionMatch::capturedView(int nth = 0) const

Devuelve una vista de la subcadena capturada por el grupo de captura nth.

Si el grupo de captura nth no capturó una cadena, o si no existe tal grupo de captura, devuelve un QStringView nulo.

Véase también captured(), lastCapturedIndex(), capturedStart(), capturedEnd(), capturedLength() y QStringView::isNull().

[since 6.3] bool QRegularExpressionMatch::hasCaptured(QAnyStringView name) const

Devuelve true si el grupo de captura llamado name capturó algo en la cadena de asunto, y false en caso contrario (o si no hay ningún grupo de captura llamado name).

QRegularExpression re("([a-z]+)|([A-Z]+)");QRegularExpressionMatch m = re.match("MAYÚSCULAS");if (m.hasMatch()) {    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

Del mismo modo, un grupo de captura puede capturar una subcadena de longitud 0; esta función devolverá true para un grupo de captura de este tipo.

Esta función se introdujo en Qt 6.3.

Véase también captured() y hasMatch().

[since 6.3] bool QRegularExpressionMatch::hasCaptured(int nth) const

Devuelve true si el grupo de captura nth capturó algo en la cadena de asunto, y false en caso contrario (o si no existe tal grupo de captura).

QRegularExpression re("([a-z]+)|([A-Z]+)");QRegularExpressionMatch m = re.match("MAYÚSCULAS");if (m.hasMatch()) {    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

Del mismo modo, un grupo de captura puede capturar una subcadena de longitud 0; esta función devolverá true para un grupo de captura de este tipo.

Esta función se introdujo en Qt 6.3.

Véase también captured(), lastCapturedIndex(), y hasMatch().

bool QRegularExpressionMatch::hasMatch() const

Devuelve true si la expresión regular coincide con la cadena de asunto, o false en caso contrario.

Véase también QRegularExpression::match() y hasPartialMatch().

bool QRegularExpressionMatch::hasPartialMatch() const

Devuelve true si la expresión regular coincide parcialmente con la cadena de asunto, o false en caso contrario.

Véase también QRegularExpression::match(), QRegularExpression::MatchType, y hasMatch().

bool QRegularExpressionMatch::isValid() const

Devuelve true si el objeto coincidente se obtuvo como resultado de la función QRegularExpression::match() invocada sobre un objeto QRegularExpression válido; devuelve false si el QRegularExpression no era válido.

Véase también QRegularExpression::match() y QRegularExpression::isValid().

int QRegularExpressionMatch::lastCapturedIndex() const

Devuelve el índice del último grupo de captura que capturó algo, incluido el grupo de captura implícito 0. Esto se puede utilizar para extraer todas las subcadenas que se capturaron:

QRegularExpressionMatch match = re.match(string);
for (int i = 0; i <= match.lastCapturedIndex(); ++i) {
    QString captured = match.captured(i);
    // ...
}

Tenga en cuenta que algunos de los grupos de captura con un índice menor que lastCapturedIndex() podrían no haber coincidido y, por tanto, no haber capturado nada.

Si la expresión regular no coincide, esta función devuelve -1.

Véase también hasCaptured(), captured(), capturedStart(), capturedEnd() y capturedLength().

QRegularExpression::MatchOptions QRegularExpressionMatch::matchOptions() const

Devuelve las opciones de coincidencia que se utilizaron para obtener este objeto QRegularExpressionMatch, es decir, las opciones de coincidencia que se pasaron a QRegularExpression::match() o QRegularExpression::globalMatch().

Véase también QRegularExpression::match(), regularExpression() y matchType().

QRegularExpression::MatchType QRegularExpressionMatch::matchType() const

Devuelve el tipo de coincidencia que se utilizó para obtener este objeto QRegularExpressionMatch, es decir, el tipo de coincidencia que se pasó a QRegularExpression::match() o QRegularExpression::globalMatch().

Véase también QRegularExpression::match(), regularExpression() y matchOptions().

QRegularExpression QRegularExpressionMatch::regularExpression() const

Devuelve el objeto QRegularExpression cuya función match() devolvió este objeto.

Véase también QRegularExpression::match(), matchType() y matchOptions().

[noexcept] void QRegularExpressionMatch::swap(QRegularExpressionMatch &other)

Intercambia este resultado de coincidencia con other. Esta operación es muy rápida y nunca falla.

[noexcept] QRegularExpressionMatch &QRegularExpressionMatch::operator=(QRegularExpressionMatch &&match)

Mover-asigna el resultado de la coincidencia match a este objeto, y devuelve una referencia al resultado.

Tenga en cuenta que un objeto movido desde QRegularExpressionMatch sólo puede ser destruido o asignado. El efecto de llamar a otras funciones que no sean el destructor o uno de los operadores de asignación es indefinido.

QRegularExpressionMatch &QRegularExpressionMatch::operator=(const QRegularExpressionMatch &match)

Asigna el resultado de la coincidencia match a este objeto y devuelve una referencia a la copia.