|Linux & Unix Commands - Search Man Pages
QStrList - Doubly-linked list of char*
Inherited by QStrIList.
QStrList ( bool deepCopies = TRUE )
QStrList ( const QStrList & list )
QStrList & operator= ( const QStrList & list )
The QStrList class provides a doubly-linked list of char*.
If you want a string list of QStrings use QStringList.
This class is a QPtrList<char> instance (a list of char*).
QStrList can make deep or shallow copies of the strings that are inserted.
A deep copy means that memory is allocated for the string and then the string data is
copied into that memory. A shallow copy is just a copy of the pointer value and not of the
string data itself.
The disadvantage of shallow copies is that because a pointer can be deleted only 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 they 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
The virtual compareItems() function is reimplemented and does a case-sensitive string
comparison. The inSort() function will insert strings in sorted order. In general it is
fastest to insert the strings as they come and sort() at the end; inSort() is useful when
you just have to add a few extra strings to an already sorted list.
The QStrListIterator class is an iterator for QStrList.
See also Collection Classes, Text Related Classes, and Non-GUI Classes.
MEMBER FUNCTION DOCUMENTATION
QStrList::QStrList ( bool deepCopies = TRUE )
Constructs an empty list of strings. Will make deep copies of all inserted strings if
deepCopies is TRUE, or use shallow copies if deepCopies is FALSE.
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.
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.
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
Generated automatically from the source code.
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you.
The definitive Qt documentation is provided in HTML format; it is located at
$QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is
provided as a convenience for those users who prefer man pages, although this format is
not officially supported by Trolltech.
If you find errors in this manual page, please report them to firstname.lastname@example.org.
Please include the name of the manual page (qstrlist.3qt) and the Qt version (3.1.1).
Trolltech AS 9 December 2002 QStrList(3qt)
All times are GMT -4. The time now is 12:54 AM.