QStringList Class Reference

A list of strings. More...

#include <qstringlist.h>

Inherits QValueList<QString>.

List of all member functions.

Public Members

• QStringList () 
• QStringList ( const QStringList & l ) 
• QStringList ( const QString & i ) 
• void sort () 

Detailed Description

This class is a list of QString objects. Like QValueList it is value based unlike QList. In contrast to QStrList it deals with real QString objects instead of character pointers. That makes QStringList the class of choice if you have to deal with unicode strings.

Like QString itself, a QStringList provides implicit share. Therefore string lists can be passed around as value-parameters both fast and safe.

Example:

        QStringList list;

        // three different ways of appending values:
        list.append( "Torben");
        list += "Warwick";
        list << "Matthias" << "Arnt" << "Paul";

        // sort the list, Arnt's now first
        list.sort();

        // print it out
        for ( QStringList::Iterator it = list.begin(); it != list.end(); ++it ) {
            printf( "%s \n", (*it).latin1() );
        }

Member Function Documentation

QStringList::QStringList ()

Creates an empty list.

QStringList::QStringList ( const QString & i )

Constructs a string list consisting of the single string i. To make longers lists easily, use:

    QString s1,s2,s3;
    ...
    QStringList mylist = QStringList() << s1 << s2 << s3;

QStringList::QStringList ( const QStringList & l )

Creates a copy of the list. This function is very fast since QStringList is implicit shared. However, for the programmer this is the same as a deep copy. If this list or the original one or some other list referencing the same shared data is modified, then the modifying list makes a copy first.

void QStringList::sort ()

Sorts the list of strings in ascending order. The sorting algorithm used is HeapSort which operates in O(n*logn).

Search the documentation, FAQ, qt-interest archive and more (uses www.troll.no):

This file is part of the Qt toolkit, copyright © 1995-99 Troll Tech, all rights reserved.