![]() |
Qt 6.x
The Qt SDK
|
\inmodule QtCore More...
#include <qstringmatcher.h>
Public Member Functions | |
QStringMatcher ()=default | |
Constructs an empty string matcher that won't match anything. | |
QStringMatcher (const QString &pattern, Qt::CaseSensitivity cs=Qt::CaseSensitive) | |
Constructs a string matcher that will search for pattern, with case sensitivity cs. | |
QStringMatcher (const QChar *uc, qsizetype len, Qt::CaseSensitivity cs=Qt::CaseSensitive) | |
QStringMatcher (QStringView pattern, Qt::CaseSensitivity cs=Qt::CaseSensitive) | |
QStringMatcher (const QStringMatcher &other) | |
Copies the other string matcher to this string matcher. | |
~QStringMatcher () | |
Destroys the string matcher. | |
QStringMatcher & | operator= (const QStringMatcher &other) |
Assigns the other string matcher to this string matcher. | |
void | setPattern (const QString &pattern) |
Sets the string that this string matcher will search for to pattern. | |
void | setCaseSensitivity (Qt::CaseSensitivity cs) |
Sets the case sensitivity setting of this string matcher to cs. | |
qsizetype | indexIn (const QString &str, qsizetype from=0) const |
Searches the string str from character position from (default 0, i.e. | |
qsizetype | indexIn (const QChar *str, qsizetype length, qsizetype from=0) const |
qsizetype | indexIn (QStringView str, qsizetype from=0) const |
QString | pattern () const |
Returns the string pattern that this string matcher will search for. | |
Qt::CaseSensitivity | caseSensitivity () const |
Returns the case sensitivity setting for this string matcher. | |
\inmodule QtCore
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 \l{QChar}s 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.
Definition at line 16 of file qstringmatcher.h.
|
default |
Constructs an empty string matcher that won't match anything.
Call setPattern() to give it a pattern to match.
|
explicit |
Constructs a string matcher that will search for pattern, with case sensitivity cs.
Call indexIn() to perform a search.
Definition at line 156 of file qstringmatcher.cpp.
|
inline |
Constructs a string matcher that will search for the pattern referred to by uc with the given length and case sensitivity specified by cs.
Definition at line 23 of file qstringmatcher.h.
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.
Definition at line 180 of file qstringmatcher.cpp.
QStringMatcher::QStringMatcher | ( | const QStringMatcher & | other | ) |
Copies the other string matcher to this string matcher.
Definition at line 188 of file qstringmatcher.cpp.
References operator=(), and other().
QStringMatcher::~QStringMatcher | ( | ) |
Destroys the string matcher.
Definition at line 197 of file qstringmatcher.cpp.
References Q_UNUSED.
|
inline |
Returns the case sensitivity setting for this string matcher.
Definition at line 43 of file qstringmatcher.h.
|
inline |
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.
Definition at line 39 of file qstringmatcher.h.
References str.
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.
Definition at line 37 of file qstringmatcher.h.
References str.
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.
Definition at line 294 of file qstringmatcher.cpp.
References bm_find(), and str.
QStringMatcher & QStringMatcher::operator= | ( | const QStringMatcher & | other | ) |
Assigns the other string matcher to this string matcher.
Definition at line 205 of file qstringmatcher.cpp.
References other().
Referenced by QStringMatcher().
QString QStringMatcher::pattern | ( | ) | const |
Returns the string pattern that this string matcher will search for.
Definition at line 238 of file qstringmatcher.cpp.
References QString::isEmpty(), and QStringView::toString().
Referenced by setPattern().
void QStringMatcher::setCaseSensitivity | ( | Qt::CaseSensitivity | cs | ) |
Sets the case sensitivity setting of this string matcher to cs.
Definition at line 251 of file qstringmatcher.cpp.
Sets the string that this string matcher will search for to pattern.
Definition at line 222 of file qstringmatcher.cpp.
References pattern().