QStringMatcher Class | Qt Core (original) (raw)

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

Member Function Documentation

[constexpr noexcept] QStringMatcher::QStringMatcher()

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

QStringMatcher::QStringMatcher(QStringView 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.

[explicit] 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 QChar *uc, qsizetype length, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Constructs a string matcher that will search for the pattern referred to by uc with the given length and case sensitivity specified by cs.

QStringMatcher::QStringMatcher(const QStringMatcher &other)

Copies the other string matcher to this string matcher.

[noexcept] QStringMatcher::~QStringMatcher()

Destroys the string matcher.

Qt::CaseSensitivity QStringMatcher::caseSensitivity() const

Returns the case sensitivity setting for this string matcher.

See also setCaseSensitivity().

qsizetype QStringMatcher::indexIn(QStringView str, qsizetype 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().

qsizetype QStringMatcher::indexIn(const QString &str, qsizetype 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().

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

Searches the string starting at str (of length length) 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().

[noexcept, since 6.7] QStringView QStringMatcher::patternView() const

Returns a string view of the pattern that this string matcher will search for.

This function was introduced in Qt 6.7.

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.