1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Qt Toolkit - QStrList Class</title><style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }body { background: white; color: black; }
--></style>
</head><body bgcolor="#ffffff">
<table width="100%">
<tr><td><a href="index.html">
<img width="100" height="100" src="qtlogo.png"
alt="Home" border="0"><img width="100"
height="100" src="face.png" alt="Home" border="0">
</a><td valign=top><div align=right><img src="dochead.png" width="472" height="27"><br>
<a href="classes.html"><b>Classes</b></a>
-<a href="annotated.html">Annotated</a>
- <a href="hierarchy.html">Tree</a>
-<a href="functions.html">Functions</a>
-<a href="index.html">Home</a>
-<a href="topicals.html"><b>Structure</b></a>
</div>
</table>
<h1 align=center>QStrList Class Reference</h1><br clear="all">
<p>
The QStrList class provides a doubly linked list of <code>char*.</code>
<a href="#details">More...</a>
<p>
<code>#include <<a href="qstrlist-h.html">qstrlist.h</a>></code>
<p>
Inherits <a href="qlist.html">QList</a>.
<p>Inherited by <a href="qstrilist.html">QStrIList</a>.
<p><a href="qstrlist-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class="fn"><a href="#af997d"><b>QStrList</b></a>(booldeepCopies=TRUE)</div>
<li><div class="fn"><a href="#2c31f5"><b>QStrList</b></a>(constQStrList&)</div>
<li><div class="fn"><a href="#94b631"><b>~QStrList</b></a>()</div>
<li><div class="fn">QStrList&<a href="#5b7426"><b>operator=</b></a>(constQStrList&)</div>
</ul>
<hr><h2><a name="details"></a>Detailed Description</h2>
The QStrList class provides a doubly linked list of <code>char*.</code>
<p>
This class is a <a href="qlist.html">QList</a><char> instance (a list of char*).
<p>QStrList can make deep or shallow copies of the strings that are inserted.
<p>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.
<p>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.
<p>A QStrList that operates on deep copies will by default turn on
auto-deletion (see <a href="qcollection.html#a8ef9f">setAutoDelete</a>()). Thus, by default, QStrList will
deallocate any string copies it allocates.
<p>The virtual <a href="qglist.html#f2a675">compareItems</a>() function is reimplemented and does a case
sensitive string comparison. The <a href="qlist.html#bf9354">inSort</a>() function will insert
strings in a sorted order.
<p>The <a href="qstrlistiterator.html">QStrListIterator</a> class is an iterator for QStrList.
<hr><h2>Member Function Documentation</h2>
<h3 class="fn"><a name="af997d"></a>QStrList::QStrList(booldeepCopies=TRUE)</h3>
<p>Constructs an empty list of strings. Will make deep copies of all inserted
strings if <em>deepCopies</em> is TRUE, or uses shallow copies if <em>deepCopies</em>
is FALSE.
<h3 class="fn"><a name="2c31f5"></a>QStrList::QStrList(constQStrList&list)</h3>
<p>Constructs a copy of <em>list.</em>
<p>If <em>list</em> 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.
<h3 class="fn"><a name="94b631"></a>QStrList::~QStrList()</h3>
<p>Destroys the list. All strings are removed.
<h3 class="fn">QStrList&<a name="5b7426"></a>QStrList::operator=(constQStrList&list)</h3>
<p>Assigns <em>list</em> to this list and returns a reference to this list.
<p>If <em>list</em> 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.
<hr><p>
Search the documentation, FAQ, qt-interest archive and more (uses
<a href="http://www.trolltech.com">www.trolltech.com</a>):<br>
<form method=post action="http://www.trolltech.com/search.cgi">
<input type=hidden name="version" value="2.3.2"><nobr>
<input size="50" name="search"><input type=submit value="Search">
</nobr></form><hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>,
copyright © 1995-2001
<a href="http://www.trolltech.com">Trolltech</a>, all rights reserved.<p><address><hr><div align="center">
<table width="100%" cellspacing="0" border="0"><tr>
<td>Copyright 2001 Trolltech<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align="right"><div align="right">Qt version 2.3.2</div>
</table></div></address></body></html>
|
