Класс QStringMatcher

Класс QStringMatcher хранит последовательность символов, которые могут быть быстро сопоставлены в строке Юникода. Подробнее...

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

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

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

Класс QStringMatcher хранит последовательность символов, которые могут быть быстро сопоставлены в строке Юникода.

Этот класс полезен, когда у вас есть последовательность QChar, которую вы хотите многократно сопоставлять с некоторыми строками (например, в цикле), или когда вы хотите искать ту же последовательность символов несколько раз в одной строке. Использование объекта матчера и indexIn() быстрее, чем сопоставление обычной строки QString с QString::indexOf(), если повторяется поиск. Этот класс не дает преимуществ, если вы выполняете однократное сопоставление строк.

Создайте QStringMatcher с QString, который вы хотите найти. Затем вызовите indexIn() на QString, который вы хотите найти.

См. также QString, QByteArrayMatcher и QRegExp.

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

QStringMatcher::QStringMatcher()

Конструирует пустой матчер строк, который ничего не будет сопоставлять. Вызовите setPattern(), чтобы задать ему шаблон для сопоставления.

QStringMatcher::QStringMatcher(const QString &pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Конструирует матчер строк, который будет искать pattern с учетом регистра cs.

Вызовите indexIn() для выполнения поиска.

QStringMatcher::QStringMatcher(const QChar *uc, int length, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Конструирует матчер строк, который будет искать шаблон, на который указывает uc, с заданной length и чувствительностью к регистру, указанной cs.

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

QStringMatcher::QStringMatcher(const QStringMatcher &other)

Копирует матчер строк other в этот матчер строк.

QStringMatcher::~QStringMatcher()

Удаляет матчер строк.

Qt::CaseSensitivity QStringMatcher::caseSensitivity() const

Возвращает настройку чувствительности к регистру для этого матчера строк.

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

int QStringMatcher::indexIn(const QString &str, int from = 0) const

Ищет строку str с позиции символа from (по умолчанию 0, т.е. с первого символа) для строки pattern(), которая была задана в конструкторе или в последнем вызове setPattern(). Возвращает позицию, где шаблон pattern() совпал в str, или -1, если совпадение не найдено.

См. также setPattern() и setCaseSensitivity().

int QStringMatcher::indexIn(const QChar *str, int length, int from = 0) const

Ищет строку, начиная с str (длины length) с позиции символа from (по умолчанию 0, т.е. с первого символа), для строки pattern(), которая была задана в конструкторе или в последнем вызове setPattern(). Возвращает позицию, где шаблон pattern() совпал в str, или -1, если совпадение не найдено.

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

См. также setPattern() и setCaseSensitivity().

QString QStringMatcher::pattern() const

Возвращает строку-шаблон, которую этот матчер строк будет искать.

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

void QStringMatcher::setCaseSensitivity(Qt::CaseSensitivity cs)

Устанавливает настройку чувствительности к регистру этого матчера строк на cs.

См. также caseSensitivity(), setPattern() и indexIn().

void QStringMatcher::setPattern(const QString &pattern)

Устанавливает строку, которую этот матчер строк будет искать, на pattern.

См. также pattern(), setCaseSensitivity() и indexIn().

QStringMatcher &QStringMatcher::operator=(const QStringMatcher &other)

Присваивает матчер строк other этому матчеру строк.