QStrList(3qt)QStrList(3qt)NAME
QStrList - Doubly linked list of
#include <qstrlist.h>
Inherits QList.
Inherited by QStrIList.
Public Members
QStrList ( bool deepCopies=TRUE )
QStrList ( const QStrList & )
~QStrList ()
QStrList& operator= ( const QStrList & )
DESCRIPTION
The QStrList class provides a doubly linked list of char*.
This class is a QList<char> instance (a list of char*).
QStrList can make deep or shallow copies of the strings
that are inserted.
A deep copy means to allocate space for the string and
then copy the string data into it. A shallow copy is just
a copy of the pointer value and not the string data.
The disadvantage with shallow copies is that since a
pointer can only be deleted once, the program must put all
strings in a central place and know when it is safe to
delete them (i.e. when the strings are no longer
referenced by other parts of the program). This can make
the program more complex. The advantage of shallow copies
is that shallow copies consume far less memory than deep
copies. It is also much faster to copy a pointer
(typically 4 or 8 bytes) than to copy string data.
A QStrList that operates on deep copies will by default
turn on auto-deletion (see setAutoDelete()). Thus, by
default, QStrList will deallocate any string copies it
allocates.
The virtual compareItems() function is reimplemented and
does a case sensitive string comparison. The inSort()
function will insert strings in a sorted order.
The QStrListIterator class is an iterator for QStrList.
MEMBER FUNCTION DOCUMENTATIONQStrList::QStrList ( bool deepCopies=TRUE )
Constructs an empty list of strings. Will make deep copies
of all inserted strings if deepCopies is TRUE, or uses
shallow copies if deepCopies is FALSE.
Trolltech AS 13 June 2001 1
QStrList(3qt)QStrList(3qt)QStrList::QStrList ( const QStrList & list )
Constructs a copy of list.
If list has deep copies, this list will also get deep
copies. Only the pointers are copied (shallow copy) if the
other list does not use deep copies.
QStrList::~QStrList ()
Destroys the list. All strings are removed.
QStrList& QStrList::operator= ( const QStrList & list )
Assigns list to this list and returns a reference to this
list.
If list has deep copies, this list will also get deep
copies. Only the pointers are copied (shallow copy) if
the other list does not use deep copies.
SEE ALSO
http://doc.trolltech.com/qstrlist.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page (qstrlist.3qt)
and the Qt version (2.3.1).
Trolltech AS 13 June 2001 2
