QRegularExpressionMatch Class

Documentation des fonctions membres

QRegularExpressionMatch::QRegularExpressionMatch()

Construit un objet QRegularExpressionMatch valide et vide. L'expression régulière est définie sur une expression construite par défaut, le type de correspondance sur QRegularExpression::NoMatch et les options de correspondance sur QRegularExpression::NoMatchOption.

L'objet ne signale aucune correspondance par l'intermédiaire des fonctions membres hasMatch() et hasPartialMatch().

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

Construit un résultat de correspondance en copiant le résultat de match.

Voir aussi operator=().

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

Construit un résultat de correspondance en déplaçant le résultat à partir de l'adresse match.

Notez qu'un QRegularExpressionMatch déplacé ne peut être que détruit ou assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi operator=().

[noexcept] QRegularExpressionMatch::~QRegularExpressionMatch()

Détruit le résultat du match.

QString QRegularExpressionMatch::captured(QAnyStringView name) const

Renvoie la sous-chaîne capturée par le groupe de capture nommé name.

Si le groupe de capture nommé name n'a pas capturé de chaîne, ou s'il n'y a pas de groupe de capture nommé name, renvoie une valeur nulle QString.

Voir aussi capturedView(), capturedStart(), capturedEnd(), capturedLength() et QString::isNull().

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

Renvoie la sous-chaîne capturée par le groupe de capture nth.

Si le groupe de capture nth n'a pas capturé de chaîne, ou s'il n'existe pas de groupe de capture, il renvoie une valeur nulle QString.

Voir aussi capturedView(), lastCapturedIndex(), capturedStart(), capturedEnd(), capturedLength() et QString::isNull().

qsizetype QRegularExpressionMatch::capturedEnd(QAnyStringView name) const

Renvoie le décalage à l'intérieur de la chaîne objet immédiatement après la position finale de la sous-chaîne capturée par le groupe de capture nommé name. Si le groupe de capture nommé name n'a pas capturé de chaîne ou n'existe pas, la fonction renvoie -1.

Voir aussi capturedStart(), capturedLength(), et captured().

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

Renvoie le décalage à l'intérieur de la chaîne du sujet immédiatement après la position finale de la sous-chaîne capturée par le groupe de capture nth. Si le groupe de capture nth n'a pas capturé de chaîne ou n'existe pas, renvoie -1.

Voir aussi capturedStart(), capturedLength(), et captured().

qsizetype QRegularExpressionMatch::capturedLength(QAnyStringView name) const

Renvoie la longueur de la sous-chaîne capturée par le groupe de capture nommé name.

Voir aussi capturedStart(), capturedEnd() et captured().

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

Renvoie la longueur de la sous-chaîne capturée par le groupe de capture nth.

Voir aussi capturedStart(), capturedEnd() et captured().

qsizetype QRegularExpressionMatch::capturedStart(QAnyStringView name) const

Renvoie le décalage à l'intérieur de la chaîne objet correspondant à la position de départ de la sous-chaîne capturée par le groupe de capture nommé name. Si le groupe de capture nommé name n'a pas capturé de chaîne ou n'existe pas, la fonction renvoie -1.

Voir aussi capturedEnd(), capturedLength(), et captured().

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

Renvoie le décalage dans la chaîne du sujet correspondant à la position de départ de la sous-chaîne capturée par le groupe de capture nth. Si le groupe de capture nth n'a pas capturé de chaîne ou n'existe pas, renvoie -1.

Voir aussi capturedEnd(), capturedLength() et captured().

QStringList QRegularExpressionMatch::capturedTexts() const

Renvoie une liste de toutes les chaînes capturées par les groupes de capture, dans l'ordre dans lequel les groupes apparaissent dans la chaîne du motif. La liste comprend le groupe de capture implicite numéro 0, qui capture la sous-chaîne correspondant à l'ensemble du motif.

QStringView QRegularExpressionMatch::capturedView(QAnyStringView name) const

Renvoie une vue de la chaîne capturée par le groupe de capture nommé name.

Si le groupe de capture nommé name n'a pas capturé de chaîne, ou s'il n'y a pas de groupe de capture nommé name, elle renvoie une valeur nulle QStringView.

Voir aussi captured(), capturedStart(), capturedEnd(), capturedLength() et QStringView::isNull().

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

Renvoie une vue de la sous-chaîne capturée par le groupe de capture nth.

Si le groupe de capture nth n'a pas capturé de chaîne, ou s'il n'existe pas de groupe de capture, il renvoie une valeur nulle QStringView.

Voir aussi captured(), lastCapturedIndex(), capturedStart(), capturedEnd(), capturedLength() et QStringView::isNull().

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

Retourne true si le groupe de capture nommé name a capturé quelque chose dans la chaîne du sujet, et false sinon (ou s'il n'y a pas de groupe de capture appelé name).

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

De même, un groupe de capture peut capturer une sous-chaîne de longueur 0 ; cette fonction renverra true pour un tel groupe de capture.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi captured() et hasMatch().

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

Retourne true si le groupe de capture nth a capturé quelque chose dans la chaîne de l'objet, et false sinon (ou s'il n'y a pas de groupe de capture).

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

De même, un groupe de capture peut capturer une sous-chaîne de longueur 0 ; cette fonction renverra true pour un tel groupe de capture.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi captured(), lastCapturedIndex(), et hasMatch().

bool QRegularExpressionMatch::hasMatch() const

Renvoie true si l'expression régulière correspond à la chaîne du sujet, ou false dans le cas contraire.

Voir aussi QRegularExpression::match() et hasPartialMatch().

bool QRegularExpressionMatch::hasPartialMatch() const

Renvoie true si l'expression régulière correspond partiellement à la chaîne de l'objet, ou false dans le cas contraire.

Voir aussi QRegularExpression::match(), QRegularExpression::MatchType, et hasMatch().

bool QRegularExpressionMatch::isValid() const

Renvoie true si l'objet de correspondance a été obtenu par la fonction QRegularExpression::match() invoquée sur un objet QRegularExpression valide ; renvoie false si l'objet QRegularExpression n'est pas valide.

Voir aussi QRegularExpression::match() et QRegularExpression::isValid().

int QRegularExpressionMatch::lastCapturedIndex() const

Renvoie l'index du dernier groupe de capture qui a capturé quelque chose, y compris le groupe de capture implicite 0. Cela peut être utilisé pour extraire toutes les sous-chaînes qui ont été capturées :

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

Notez que certains des groupes de capture dont l'index est inférieur à lastCapturedIndex() peuvent ne pas avoir été trouvés, et donc n'avoir rien capturé.

Si l'expression régulière ne correspond pas, cette fonction renvoie -1.

Voir aussi hasCaptured(), captured(), capturedStart(), capturedEnd() et capturedLength().

QRegularExpression::MatchOptions QRegularExpressionMatch::matchOptions() const

Renvoie les options de correspondance qui ont été utilisées pour obtenir cet objet QRegularExpressionMatch, c'est-à-dire les options de correspondance qui ont été transmises à QRegularExpression::match() ou QRegularExpression::globalMatch().

Voir aussi QRegularExpression::match(), regularExpression() et matchType().

QRegularExpression::MatchType QRegularExpressionMatch::matchType() const

Renvoie le type de correspondance utilisé pour obtenir cet objet QRegularExpressionMatch, c'est-à-dire le type de correspondance transmis à QRegularExpression::match() ou QRegularExpression::globalMatch().

Voir aussi QRegularExpression::match(), regularExpression() et matchOptions().

QRegularExpression QRegularExpressionMatch::regularExpression() const

Renvoie l'objet QRegularExpression dont la fonction match() a renvoyé cet objet.

Voir aussi QRegularExpression::match(), matchType(), et matchOptions().

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

Remplace ce résultat par other. Cette opération est très rapide et n'échoue jamais.

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

Move-assigne le résultat de la correspondance match à cet objet et renvoie une référence au résultat.

Notez qu'un objet déplacé de QRegularExpressionMatch ne peut être détruit ou affecté qu'à cet objet. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

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

Affecte le résultat de la correspondance match à cet objet et renvoie une référence à la copie.