QStringList Class Reference
[QtCore module]

Manipulating the strings

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. For example:

     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. For example:

     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.

Member Function Documentation

     QStringList longerList = (QStringList() << str1 << str2 << str3);

     QStringList list;
     list << "Bill Murray" << "John Doe" << "Bill Clinton";

     QStringList result;
     result = list.filter("Bill");
     // result: ["Bill Murray", "Bill Clinton"]

     QStringList result;
     foreach (QString str, list) {
         if (str.contains("Bill"))
             result += str;
     }

     QStringList list;
     list << "alpha" << "beta" << "gamma" << "epsilon";
     list.replaceInStrings("a", "o");
     // list == ["olpho", "beto", "gommo", "epsilon"]

     QStringList list;
     list << "alpha" << "beta" << "gamma" << "epsilon";
     list.replaceInStrings(QRegExp("^a"), "o");
     // list == ["olpha", "beta", "gamma", "epsilon"]

     QStringList list;
     list << "Bill Clinton" << "Murray, Bill";
     list.replaceInStrings(QRegExp("^(.*), (.*)$"), "\\2 \\1");
     // list == ["Bill Clinton", "Bill Murray"]