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. It behaves essentially like the above function.

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 find() instead.

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Use find() instead.

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

Use replace() instead.

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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Use replace() 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. It behaves essentially like the above function.

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. It behaves essentially like the above function.

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().