Класс 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 этому совпадающему объекту строк.