<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- q3ptrlist.qdoc -->
<title>Qt 4.8: Q3StrList Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li>Qt3SupportLight</li>
<li>Q3StrList</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">Q3StrList Class Reference</h1>
<!-- $$$Q3StrList-brief -->
<p>The Q3StrList class provides a doubly-linked list of char*. <a href="#details">More...</a></p>
<!-- @@@Q3StrList -->
<pre class="cpp"> <span class="preprocessor">#include <Q3StrList></span></pre><p><b>This class is part of the Qt 3 support library.</b> It is provided to keep old source code working. We strongly advise against using it in new code. See <a href="porting4.html">Porting to Qt 4</a> for more information.</p>
<p><b>Inherits: </b><a href="q3ptrlist.html">Q3PtrList<char></a>.</p>
<p><b>Inherited by: </b><a href="q3strilist.html">Q3StrIList</a>.</p>
<ul>
<li><a href="q3strlist-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#Q3StrList">Q3StrList</a></b> ( bool <i>deepCopies</i> = true )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#Q3StrList-2">Q3StrList</a></b> ( const Q3StrList & <i>list</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#Q3StrList-3">Q3StrList</a></b> ( const QList<QByteArray> & <i>list</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#dtor.Q3StrList">~Q3StrList</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#operator-QList-ltQByteArray-gt">operator QList<QByteArray></a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3StrList & </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#operator-eq">operator=</a></b> ( const Q3StrList & <i>list</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3StrList & </td><td class="memItemRight bottomAlign"><b><a href="q3strlist.html#operator-eq-2">operator=</a></b> ( const QList<QByteArray> & <i>list</i> )</td></tr>
</table>
<ul>
<li class="fn">39 public functions inherited from <a href="q3ptrlist.html#public-functions">Q3PtrList</a></li>
<li class="fn">4 public functions inherited from <a href="q3ptrcollection.html#public-functions">Q3PtrCollection</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">3 protected functions inherited from <a href="q3ptrlist.html#protected-functions">Q3PtrList</a></li>
<li class="fn">2 protected functions inherited from <a href="q3ptrcollection.html#protected-functions">Q3PtrCollection</a></li>
</ul>
<a name="details"></a>
<!-- $$$Q3StrList-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The Q3StrList class provides a doubly-linked list of char*.</p>
<p>If you want a string list of <a href="qstring.html">QString</a>s use <a href="qstringlist.html">QStringList</a>.</p>
<p>This class is a <a href="q3ptrlist.html">Q3PtrList</a><char> instance (a list of char*).</p>
<p>Q3StrList can make deep or shallow copies of the strings that are inserted.</p>
<p>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.</p>
<p>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.</p>
<p>A Q3StrList that operates on deep copies will, by default, turn on auto-deletion (see <a href="q3ptrcollection.html#setAutoDelete">setAutoDelete</a>()). Thus, by default Q3StrList will deallocate any string copies it allocates.</p>
<p>The virtual <a href="q3ptrlist.html#compareItems">compareItems</a>() function is reimplemented and does a case-sensitive string comparison. The <a href="q3ptrlist.html#inSort">inSort</a>() function will insert strings in sorted order. In general it is fastest to insert the strings as they come and <a href="q3ptrlist.html#sort">sort</a>() at the end; <a href="q3ptrlist.html#inSort">inSort</a>() is useful when you just have to add a few extra strings to an already sorted list.</p>
<p>The <a href="q3strlistiterator.html">Q3StrListIterator</a> class is an iterator for Q3StrList.</p>
</div>
<!-- @@@Q3StrList -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$Q3StrList[overload1]$$$Q3StrListbool -->
<h3 class="fn"><a name="Q3StrList"></a>Q3StrList::<span class="name">Q3StrList</span> ( <span class="type">bool</span> <i>deepCopies</i> = true )</h3>
<p>Constructs an empty list of strings. Will make deep copies of all inserted strings if <i>deepCopies</i> is TRUE, or use shallow copies if <i>deepCopies</i> is FALSE.</p>
<!-- @@@Q3StrList -->
<!-- $$$Q3StrList$$$Q3StrListconstQ3StrList& -->
<h3 class="fn"><a name="Q3StrList-2"></a>Q3StrList::<span class="name">Q3StrList</span> ( const <span class="type">Q3StrList</span> & <i>list</i> )</h3>
<p>Constructs a copy of <i>list</i>.</p>
<!-- @@@Q3StrList -->
<!-- $$$Q3StrList$$$Q3StrListconstQList<QByteArray>& -->
<h3 class="fn"><a name="Q3StrList-3"></a>Q3StrList::<span class="name">Q3StrList</span> ( const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>> & <i>list</i> )</h3>
<p>Constructs a copy of <i>list</i>.</p>
<!-- @@@Q3StrList -->
<!-- $$$~Q3StrList[overload1]$$$~Q3StrList -->
<h3 class="fn"><a name="dtor.Q3StrList"></a>Q3StrList::<span class="name">~Q3StrList</span> ()</h3>
<p>Destroys the list. All strings are removed.</p>
<!-- @@@~Q3StrList -->
<!-- $$$operator QList<QByteArray>[overload1]$$$operator QList<QByteArray> -->
<h3 class="fn"><a name="operator-QList-ltQByteArray-gt"></a>Q3StrList::<span class="name">operator QList<QByteArray></span> () const</h3>
<p>Automatically converts a <a href="q3strlist.html" class="compat">Q3StrList</a> into a <a href="qlist.html">QList</a><<a href="qbytearray.html">QByteArray</a>>.</p>
<!-- @@@operator QList<QByteArray> -->
<!-- $$$operator=[overload1]$$$operator=constQ3StrList& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">Q3StrList</span> & Q3StrList::<span class="name">operator=</span> ( const <span class="type">Q3StrList</span> & <i>list</i> )</h3>
<p>Assigns <i>list</i> to this list and returns a reference to this list.</p>
<!-- @@@operator= -->
<!-- $$$operator=$$$operator=constQList<QByteArray>& -->
<h3 class="fn"><a name="operator-eq-2"></a><span class="type">Q3StrList</span> & Q3StrList::<span class="name">operator=</span> ( const <span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qbytearray.html">QByteArray</a></span>> & <i>list</i> )</h3>
<p>Assigns <i>list</i> to this list and returns a reference to this list.</p>
<!-- @@@operator= -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
