Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QStringMatcher Class Reference
^{[модуль QtCore ]}

The QStringMatcher class holds a sequence of characters that can be quickly matched in a Unicode string. Далее...

 #include <QStringMatcher>

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

[править] Открытые функции

• QStringMatcher ()
• QStringMatcher ( const QString & pattern, Qt::CaseSensitivity cs = Qt::CaseSensitive )
• QStringMatcher ( const QStringMatcher & other )
• ~QStringMatcher ()
• Qt::CaseSensitivity caseSensitivity () const
• int indexIn ( const QString & str, int from = 0 ) const
• QString pattern () const
• void setCaseSensitivity ( Qt::CaseSensitivity cs )
• void setPattern ( const QString & pattern )
• QStringMatcher & operator= ( const QStringMatcher & other )

[править] Подробное описание

The QStringMatcher class holds a sequence of characters that can be quickly matched in a Unicode string.

This class is useful when you have a sequence of QChars that you want to repeatedly match against some strings (perhaps in a loop), or when you want to search for the same sequence of characters multiple times in the same string. Using a matcher object and indexIn() is faster than matching a plain QString with QString::indexOf() if repeated matching takes place. This class offers no benefit if you are doing one-off string matches.

Create the QStringMatcher with the QString you want to search for. Then call indexIn() on the QString that you want to search.

See also QString, QByteArrayMatcher, and QRegExp.

[править] Описание функций-членов

[править]

QStringMatcher::QStringMatcher ()

Constructs an empty string matcher that won't match anything. Call setPattern() to give it a pattern to match.

[править]

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

Constructs a string matcher that will search for pattern, with case sensitivity cs.

Call indexIn() to perform a search.

[править]

QStringMatcher::QStringMatcher ( const QStringMatcher & other )

Copies the other string matcher to this string matcher.

[править]

QStringMatcher::~QStringMatcher ()

Destroys the string matcher.

[править]

Qt::CaseSensitivity QStringMatcher::caseSensitivity () const

Returns the case sensitivity setting for this string matcher.

See also setCaseSensitivity().

[править]

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

Searches the string str from character position from (default 0, i.e. from the first character), for the string pattern() that was set in the constructor or in the most recent call to setPattern(). Returns the position where the pattern() matched in str, or -1 if no match was found.

See also setPattern() and setCaseSensitivity().

[править]

QString QStringMatcher::pattern () const

Returns the string pattern that this string matcher will search for.

See also setPattern().

[править]

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

Sets the case sensitivity setting of this string matcher to cs.

See also caseSensitivity(), setPattern(), and indexIn().

[править]

void QStringMatcher::setPattern ( const QString & pattern )

Sets the string that this string matcher will search for to pattern.

See also pattern(), setCaseSensitivity(), and indexIn().

[править]

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

Assigns the other string matcher to this string matcher.