Класс QRegularExpressionMatchIterator

Класс QRegularExpressionMatchIterator предоставляет итератор по результатам глобального сопоставления объекта QRegularExpression с строкой. Подробнее...

Этот класс был введён в Qt 5.0.

• Список всех членов, включая унаследованные

Примечание: Все функции этого класса являются внутрипоточными (реентерабельными).

Открытые функции

Подробное описание

Объект QRegularExpressionMatchIterator — это итератор по типу Java, поддерживающий только движение вперёд; он может быть получен, вызвав функцию QRegularExpression::globalMatch(). Новый QRegularExpressionMatchIterator будет расположен перед первым результатом. Затем вы можете вызвать функцию hasNext(), чтобы проверить, есть ли ещё результаты; в противном случае функция next() вернёт следующий результат и переместит итератор.

Каждый результат — объект QRegularExpressionMatch, содержащий всю информацию для этого результата (включая подстроки, полученные при сопоставлении).

Например:

// extracts the words
QRegularExpression re("(\\w+)");
QString subject("the quick fox");
QRegularExpressionMatchIterator i = re.globalMatch(subject);
while (i.hasNext()) {
    QRegularExpressionMatch match = i.next();
    // ...
}

Кроме того, QRegularExpressionMatchIterator предлагает функцию peekNext() для получения следующего результата без перемещения итератора.

Вы можете получить объект QRegularExpression, по которому производилось сопоставление, вызвав функцию regularExpression(); тип сопоставления и опции сопоставления также доступны путём вызова функций matchType() и matchOptions() соответственно.

Дополнительную информацию о классах регулярных выражений Qt см. в документации к QRegularExpression.

См. также QRegularExpression и QRegularExpressionMatch.

Документация по функциям-членам

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

Конструирует объект QRegularExpressionMatchIterator как копию iterator.

См. также operator=().

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

Конструирует пустой, корректный объект QRegularExpressionMatchIterator. Регулярное выражение установлено в значение по умолчанию; тип сопоставления — QRegularExpression::NoMatch, а опции сопоставления — QRegularExpression::NoMatchOption.

Вызов члена hasNext() для созданного объекта вернёт false, так как итератор не итерируется по корректной последовательности сопоставлений.

Эта функция была введена в Qt 5.1.

QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(QRegularExpressionMatchIterator &&iterator)

Перемещающая присваивает iterator этому объекту.

QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(const QRegularExpressionMatchIterator &iterator)

Присваивает итератор iterator этому объекту и возвращает ссылку на копию.

QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

Удаляет объект QRegularExpressionMatchIterator.

bool QRegularExpressionMatchIterator::hasNext() const

Возвращает true , если впереди итератора есть хотя бы один результат сопоставления; в противном случае возвращает false.

См. также next().

bool QRegularExpressionMatchIterator::isValid() const

Возвращает true , если объект итератора был получен в результате вызова функции QRegularExpression::globalMatch() для корректного объекта QRegularExpression; возвращает false , если QRegularExpression был некорректным.

См. также QRegularExpression::globalMatch() и QRegularExpression::isValid().

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

Возвращает опции сопоставления, которые использовались для получения этого объекта QRegularExpressionMatchIterator, то есть опции сопоставления, переданные в QRegularExpression::globalMatch().

См. также QRegularExpression::globalMatch(), regularExpression() и matchType().

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

Возвращает тип сопоставления, который использовался для получения этого объекта QRegularExpressionMatchIterator, то есть тип сопоставления, переданный в QRegularExpression::globalMatch().

См. также QRegularExpression::globalMatch(), regularExpression() и matchOptions().

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

Возвращает следующий результат сопоставления и перемещает итератор на одну позицию вперёд.

Примечание: Вызов этой функции в конце набора результатов приводит к неопределённым последствиям.

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

Возвращает следующий результат сопоставления без перемещения итератора.

Примечание: Вызов этой функции в конце набора результатов приводит к неопределённым последствиям.

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

Возвращает объект QRegularExpression, функция глобального совпадения которого вернула этот объект.

См. также QRegularExpression::globalMatch(), matchType() и matchOptions().

void QRegularExpressionMatchIterator::swap(QRegularExpressionMatchIterator &other)

Меняет местами итератор other с этим итератором. Эта операция очень быстрая и никогда не терпит неудачу.