QStringList Class Reference
|
QStringList () | |
QStringList ( const QString & str ) | |
QStringList ( const QStringList & other ) | |
QStringList ( const QList<QString> & other ) | |
bool | contains ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const |
QStringList | filter ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const |
QStringList | filter ( const QRegExp & rx ) const |
int | indexOf ( const QRegExp & rx, int from = 0 ) const |
int | indexOf ( const QString & value, int from = 0 ) const |
int | indexOf ( QRegExp & rx, int from = 0 ) const |
QString | join ( const QString & separator ) const |
int | lastIndexOf ( const QRegExp & rx, int from = -1 ) const |
int | lastIndexOf ( const QString & value, int from = -1 ) const |
int | lastIndexOf ( QRegExp & rx, int from = -1 ) const |
int | removeDuplicates () |
QStringList & | replaceInStrings ( const QString & before, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive ) |
QStringList & | replaceInStrings ( const QRegExp & rx, const QString & after ) |
void | sort () |
QStringList | operator+ ( const QStringList & other ) const |
QStringList & | operator<< ( const QString & str ) |
QStringList & | operator<< ( const QStringList & other ) |
typedef | QMutableStringListIterator |
typedef | QStringListIterator |
QDataStream & | operator<< ( QDataStream & out, const QStringList & list ) |
QDataStream & | operator>> ( QDataStream & in, QStringList & list ) |
The QStringList class provides a list of strings.
QStringList inherits from QList<QString>. Like QList, QStringList is implicitly shared. It provides fast index-based access as well as fast insertions and removals. Passing string lists as value parameters is both fast and safe.
All of QList's functionality also applies to QStringList. For example, you can use isEmpty() to test whether the list is empty, and you can call functions like append(), prepend(), insert(), replace(), removeAll(), removeAt(), removeFirst(), removeLast(), and removeOne() to modify a QStringList. In addition, QStringList provides a few convenience functions that make handling lists of strings easier:
Strings can be added to a list using the append(), operator+=() and operator<<() functions. Например:
QStringList fonts; fonts << "Arial" << "Helvetica" << "Times" << "Courier";
To iterate over a list, you can either use index positions or QList's Java-style and STL-style iterator types:
Indexing:
for (int i = 0; i < fonts.size(); ++i) cout << fonts.at(i).toLocal8Bit().constData() << endl;
Java-style iterator:
QStringListIterator javaStyleIterator(fonts); while (javaStyleIterator.hasNext()) cout << javaStyleIterator.next().toLocal8Bit().constData() << endl;
STL-style iterator:
QStringList::const_iterator constIterator; for (constIterator = fonts.constBegin(); constIterator != fonts.constEnd(); ++constIterator) cout << (*constIterator).toLocal8Bit().constData() << endl;
The QStringListIterator class is simply a type definition for QListIterator<QString>. QStringList also provide the QMutableStringListIterator class which is a type definition for QMutableListIterator<QString>.
QStringList provides several functions allowing you to manipulate the contents of a list. You can concatenate all the strings in a string list into a single string (with an optional separator) using the join() function. Например:
QString str = fonts.join(",");
// str == "Arial,Helvetica,Times,Courier"
To break up a string into a string list, use the QString::split() function:
QStringList list;
list = str.split(",");
// list: ["Arial", "Helvetica", "Times", "Courier"]
The argument to split can be a single character, a string, or a QRegExp.
In addition, the operator+() function allows you to concatenate two string lists into one. To sort a string list, use the sort() function.
QString list also provides the filter() function which lets you to extract a new list which contains only those strings which contain a particular substring (or match a particular regular expression):
QStringList monospacedFonts = fonts.filter(QRegExp("Courier|Fixed"));
The contains() function tells you whether the list contains a given string, while the indexOf() function returns the index of the first occurrence of the given string. The lastIndexOf() function on the other hand, returns the index of the last occurrence of the string.
Finally, the replaceInStrings() function calls QString::replace() on each string in the string list in turn. Например:
QStringList files;
files << "$QTDIR/src/moc/moc.y"
<< "$QTDIR/src/moc/moc.l"
<< "$QTDIR/include/qconfig.h";
files.replaceInStrings("$QTDIR", "/usr/lib/qt");
// files: [ "/usr/lib/qt/src/moc/moc.y", ...]
See also QString.
Constructs an empty string list.
Constructs a string list that contains the given string, str. Longer lists are easily created like this:
QStringList longerList = (QStringList() << str1 << str2 << str3);
Смотрите также append().
Constructs a copy of the other string list.
This operation takes constant time because QStringList is implicitly shared, making the process of returning a QStringList from a function very fast. Если экземпляр с разделением данных изменяется, то он будет скопирован (copy-on-write), и это потребует линейного времени.
Смотрите также operator=().
Создаёт копию other.
This operation takes constant time, because QStringList is implicitly shared. This makes returning a QStringList from a function very fast. Если экземпляр с разделением данных изменяется, то он будет скопирован (copy-on-write), и это потребует линейного времени.
Смотрите также operator=().
Returns true if the list contains the string str; otherwise returns false. The search is case insensitive if cs is Qt::CaseInsensitive; the search is case sensitive by default.
See also indexOf(), lastIndexOf(), and QString::contains().
Returns a list of all the strings containing the substring str.
If cs is Qt::CaseSensitive (the default), the string comparison is case sensitive; otherwise the comparison is case insensitive.
QStringList list;
list << "Bill Murray" << "John Doe" << "Bill Clinton";
QStringList result;
result = list.filter("Bill");
// result: ["Bill Murray", "Bill Clinton"]
This is equivalent to
QStringList result; foreach (QString str, list) { if (str.contains("Bill")) result += str; }
Смотрите также contains().
Это перегруженная функция.
Returns a list of all the strings that match the regular expression rx.
Returns the index position of the first exact match of rx in the list, searching forward from index position from. Возвращает -1, если нет соответствующих элементов.
By default, this function is case sensitive.
See also lastIndexOf(), contains(), and QRegExp::exactMatch().
Returns the index position of the first occurrence of value in the list, searching forward from index position from. Возвращает -1, если нет соответствующих элементов.
See also lastIndexOf(), contains(), and QList::indexOf().
Эта функция перегружает функцию indexOf().
Returns the index position of the first exact match of rx in the list, searching forward from index position from. Возвращает -1, если нет соответствующих элементов.
By default, this function is case sensitive.
If an item matched, the rx regular expression will contain the matched objects (see QRegExp::matchedLength, QRegExp::cap).
Эта функция была введена в Qt 4.5.
See also lastIndexOf(), contains(), and QRegExp::exactMatch().
Joins all the string list's strings into a single string with each element separated by the given separator (which can be an empty string).
See also QString::split().
Returns the index position of the last exact match of rx in the list, searching backward from index position from. Если from равен -1 (по умолчанию), то поиск начинается с последнего элемента. Возвращает -1, если нет соответствующих элементов.
By default, this function is case sensitive.
See also indexOf(), contains(), and QRegExp::exactMatch().
Returns the index position of the last occurrence of value in the list, searching backward from index position from. Если from равен -1 (по умолчанию), то поиск начинается с последнего элемента. Возвращает -1, если нет соответствующих элементов.
By default, this function is case sensitive.
See also indexOf() and QList::lastIndexOf().
Эта функция перегружает функцию lastIndexOf().
Returns the index position of the last exact match of rx in the list, searching backward from index position from. Если from равен -1 (по умолчанию), то поиск начинается с последнего элемента. Возвращает -1, если нет соответствующих элементов.
By default, this function is case sensitive.
If an item matched, the rx regular expression will contain the matched objects (see QRegExp::matchedLength, QRegExp::cap).
Эта функция была введена в Qt 4.5.
See also indexOf(), contains(), and QRegExp::exactMatch().
This function removes duplicate entries from a list. The entries do not have to be sorted. They will retain their original order.
Returns the number of removed entries.
Эта функция была введена в Qt 4.5.
Returns a string list where every string has had the before text replaced with the after text wherever the before text is found. The before text is matched case-sensitively or not depending on the cs flag.
Например:
QStringList list;
list << "alpha" << "beta" << "gamma" << "epsilon";
list.replaceInStrings("a", "o");
// list == ["olpho", "beto", "gommo", "epsilon"]
See also QString::replace().
Это перегруженная функция.
Replaces every occurrence of the regexp rx, in each of the string lists's strings, with after. Returns a reference to the string list.
Например:
QStringList list;
list << "alpha" << "beta" << "gamma" << "epsilon";
list.replaceInStrings(QRegExp("^a"), "o");
// list == ["olpha", "beta", "gamma", "epsilon"]
For regular expressions that contain capturing parentheses, occurrences of \1, \2, ..., in after are replaced with rx.cap(1), rx.cap(2), ...
Например:
QStringList list;
list << "Bill Clinton" << "Murray, Bill";
list.replaceInStrings(QRegExp("^(.*), (.*)$"), "\\2 \\1");
// list == ["Bill Clinton", "Bill Murray"]
Sorts the list of strings in ascending order (case sensitively).
Sorting is performed using Qt's qSort() algorithm, which operates in linear-logarithmic time, i.e. O(n log n).
If you want to sort your strings in an arbitrary order, consider using the QMap class. For example, you could use a QMap<QString, QString> to create a case-insensitive ordering (e.g. with the keys being lower-case versions of the strings, and the values being the strings), or a QMap<int, QString> to sort the strings by some integer index.
See also qSort().
Returns a string list that is the concatenation of this string list with the other string list.
Смотрите также append().
Appends the given string, str, to this string list and returns a reference to the string list.
Смотрите также append().
Это перегруженная функция.
Appends the other string list to the string list and returns a reference to the latter string list.
The QStringListIterator type definition provides a Java-style non-const iterator for QStringList.
QStringList provides both Java-style iterators and STL-style iterators. The Java-style non-const iterator is simply a type definition for QMutableListIterator<QString>.
See also QStringListIterator and QStringList::iterator.
The QStringListIterator type definition provides a Java-style const iterator for QStringList.
QStringList provides both Java-style iterators and STL-style iterators. The Java-style const iterator is simply a type definition for QListIterator<QString>.
See also QMutableStringListIterator and QStringList::const_iterator.
Writes the given string list to the specified out stream.
Смотрите также Формат операторов QDataStream.
Reads a string list from the given in stream into the specified list.
Смотрите также Формат операторов QDataStream.
Авторские права © 2010 Nokia Corporation и/или её дочерние компании | Торговые марки | Qt 4.6.4 |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |