Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Qt 3 Support Members for QStringList

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

• QStringList class reference

Public Functions

• Iterator fromLast ()
• ConstIterator fromLast () const
• QStringList grep ( const QString & str, bool cs = true ) const
• QStringList grep ( const QRegExp & rx ) const
• QStringList & gres ( const QRegExp & rx, const QString & after )
• QStringList & gres ( const QString & before, const QString & after, bool cs = true )

• 7 public functions inherited from QList

Static Public Members

• QStringList split ( const QRegExp & sep, const QString & str, bool allowEmptyEntries = false )
• QStringList split ( const QChar & sep, const QString & str, bool allowEmptyEntries = false )
• QStringList split ( const QString & sep, const QString & str, bool allowEmptyEntries = false )

Member Function Documentation

Iterator QStringList::fromLast ()

Use end() instead.

For example, if you have code like

 QStringList::Iterator i = list.fromLast();

you can rewrite it as

 QStringList::Iterator i = list.isEmpty() ? list.end() : --list.end();

ConstIterator QStringList::fromLast () const

This is an overloaded member function, provided for convenience.

Use end() instead.

For example, if you have code like

 QStringList::ConstIterator i = list.fromLast();

you can rewrite it as

 QStringList::ConstIterator i = list.isEmpty() ? list.end() : --list.end();

QStringList QStringList::grep ( const QString & str, bool cs = true ) const

Use filter() instead.

QStringList QStringList::grep ( const QRegExp & rx ) const

This is an overloaded member function, provided for convenience.

Use filter() instead.

QStringList & QStringList::gres ( const QRegExp & rx, const QString & after )

Use replaceInStrings() instead.

QStringList & QStringList::gres ( const QString & before, const QString & after, bool cs = true )

This is an overloaded member function, provided for convenience.

Use replaceInStrings() instead.

QStringList QStringList::split ( const QRegExp & sep, const QString & str, bool allowEmptyEntries = false )   [static]

Splits the string str into strings wherever the regular expression sep occurs, and returns the list of those strings.

If allowEmptyEntries is true, an empty string is inserted in the list wherever the separator matches twice without intervening text.

For example, if you split the string "a,,b,c" on commas, split() returns the three-item list "a", "b", "c" if allowEmptyEntries is false (the default), and the four-item list "a", "", "b", "c" if allowEmptyEntries is true.

Use split(QRegExp("\\s+"), str) to split on arbitrary amounts of whitespace.

If sep does not match anywhere in str, split() returns a single element list with the element containing the original string, str.

See also join() and QString::section().

QStringList QStringList::split ( const QChar & sep, const QString & str, bool allowEmptyEntries = false )   [static]

This is an overloaded member function, provided for convenience.

This version of the function uses a QChar as separator.

See also join() and QString::section().

QStringList QStringList::split ( const QString & sep, const QString & str, bool allowEmptyEntries = false )   [static]

This is an overloaded member function, provided for convenience.

This version of the function uses a QString as separator.

If sep is an empty string, the return value is a list of one-character strings: split(QString(""), "four") returns the four-item list, "f", "o", "u", "r".

If allowEmptyEntries is true, an empty string is inserted in the list wherever the separator matches twice without intervening text.

See also join() and QString::section().