Класс 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 этому согласователю строк.