Contents

• Public Functions
• Detailed Description

Detailed Description

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

This class is useful when you have a sequence ofQChars 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 andindexIn() is faster than matching a plainQString withQString::indexOf() if repeated matching takes place. This class offers no benefit if you are doing one-off string matches.

Create theQStringMatcher with theQString you want to search for. Then callindexIn() on theQString that you want to search.

Member Function Documentation

QStringMatcher::QStringMatcher()

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

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

Constructs a string matcher that will search forpattern, with case sensitivitycs.

CallindexIn() to perform a search.

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

Constructs a string matcher that will search for the pattern referred to byuc with the givenlength and case sensitivity specified bycs.

This function was introduced in Qt 4.5.

QStringMatcher::QStringMatcher(constQStringMatcher & other)

Copies theother 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 alsosetCaseSensitivity().

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

Searches the stringstr from character positionfrom (default 0, i.e. from the first character), for the stringpattern() that was set in the constructor or in the most recent call tosetPattern(). Returns the position where thepattern() matched instr, or -1 if no match was found.

See alsosetPattern() andsetCaseSensitivity().

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

Searches the string starting atstr (of lengthlength) from character positionfrom (default 0, i.e. from the first character), for the stringpattern() that was set in the constructor or in the most recent call tosetPattern(). Returns the position where thepattern() matched instr, or -1 if no match was found.

This function was introduced in Qt 4.5.

See alsosetPattern() andsetCaseSensitivity().

QString QStringMatcher::pattern() const

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

See alsosetPattern().

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

Sets the case sensitivity setting of this string matcher tocs.

See alsocaseSensitivity(),setPattern(), andindexIn().

void QStringMatcher::setPattern(constQString & pattern)

Sets the string that this string matcher will search for topattern.

See alsopattern(),setCaseSensitivity(), andindexIn().

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

Assigns theother string matcher to this string matcher.