Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 1f9eb832ba1e4b88d9a5c2b384813bb4 > files > 1016

kdelibs3-apidocs-3.5.10-31.fc15.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>kabc: addressee.src.cpp Source File (kabc)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>

  <div id="nav_header_title" align="left">KDE API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
 / <a href=".">kabc</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <a name="content"></a>


<!-- Generated by Doxygen 1.7.4 -->
<div class="header">
  <div class="headertitle">
<div class="title">addressee.src.cpp</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment">    This file is part of libkabc.</span>
<a name="l00003"></a>00003 <span class="comment">    Copyright (c) 2001 Cornelius Schumacher &lt;schumacher@kde.org&gt;</span>
<a name="l00004"></a>00004 <span class="comment">    Copyright (c) 2003 Carsten Pfeiffer &lt;pfeiffer@kde.org&gt;</span>
<a name="l00005"></a>00005 <span class="comment">    Copyright (c) 2005 Ingo Kloecker &lt;kloecker@kde.org&gt;</span>
<a name="l00006"></a>00006 <span class="comment"></span>
<a name="l00007"></a>00007 <span class="comment">    This library is free software; you can redistribute it and/or</span>
<a name="l00008"></a>00008 <span class="comment">    modify it under the terms of the GNU Library General Public</span>
<a name="l00009"></a>00009 <span class="comment">    License as published by the Free Software Foundation; either</span>
<a name="l00010"></a>00010 <span class="comment">    version 2 of the License, or (at your option) any later version.</span>
<a name="l00011"></a>00011 <span class="comment"></span>
<a name="l00012"></a>00012 <span class="comment">    This library is distributed in the hope that it will be useful,</span>
<a name="l00013"></a>00013 <span class="comment">    but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00014"></a>00014 <span class="comment">    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU</span>
<a name="l00015"></a>00015 <span class="comment">    Library General Public License for more details.</span>
<a name="l00016"></a>00016 <span class="comment"></span>
<a name="l00017"></a>00017 <span class="comment">    You should have received a copy of the GNU Library General Public License</span>
<a name="l00018"></a>00018 <span class="comment">    along with this library; see the file COPYING.LIB.  If not, write to</span>
<a name="l00019"></a>00019 <span class="comment">    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00020"></a>00020 <span class="comment">    Boston, MA 02110-1301, USA.</span>
<a name="l00021"></a>00021 <span class="comment">*/</span>
<a name="l00022"></a>00022 
<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;qregexp.h&gt;</span>
<a name="l00024"></a>00024 
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;ksharedptr.h&gt;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &lt;kapplication.h&gt;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/klocale_8h.html">klocale.h</a>&gt;</span>
<a name="l00029"></a>00029 
<a name="l00030"></a>00030 <span class="preprocessor">#include &quot;addresseehelper.h&quot;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &quot;field.h&quot;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &quot;resource.h&quot;</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include &quot;sortmode.h&quot;</span>
<a name="l00034"></a>00034 
<a name="l00035"></a>00035 <span class="preprocessor">#include &quot;addressee.h&quot;</span>
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 <span class="keyword">using namespace </span>KABC;
<a name="l00038"></a>00038 
<a name="l00039"></a>00039 <span class="keyword">static</span> <span class="keywordtype">bool</span> matchBinaryPattern( <span class="keywordtype">int</span> value, <span class="keywordtype">int</span> pattern );
<a name="l00040"></a>00040 
<a name="l00041"></a>00041 <span class="keyword">template</span> &lt;<span class="keyword">class</span> L&gt;
<a name="l00042"></a>00042 <span class="keyword">static</span> <span class="keywordtype">bool</span> listEquals( <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList&lt;L&gt;</a>&amp;, <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList&lt;L&gt;</a>&amp; );
<a name="l00043"></a>00043 <span class="keyword">static</span> <span class="keywordtype">bool</span> emailsEquals( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp;, <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp; );
<a name="l00044"></a>00044 
<a name="l00045"></a>00045 <a class="code" href="classKABC_1_1SortMode.html" title="Sort method for sorting an addressee list.">KABC::SortMode</a> *Addressee::mSortMode = 0;
<a name="l00046"></a>00046 
<a name="l00047"></a>00047 <span class="keyword">struct </span>Addressee::AddresseeData : <span class="keyword">public</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShared.html">KShared</a>
<a name="l00048"></a>00048 {
<a name="l00049"></a>00049   <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">uid</a>;
<a name="l00050"></a>00050   --VARIABLES--
<a name="l00051"></a>00051 
<a name="l00052"></a>00052   <a class="codeRef" href="qvaluelist.html">PhoneNumber::List</a> <a class="code" href="classKABC_1_1Addressee.html#a3f01378d745b242c39cb686b2be1153f" title="Return list of all phone numbers.">phoneNumbers</a>;
<a name="l00053"></a>00053   <a class="codeRef" href="qvaluelist.html">Address::List</a> <a class="code" href="classKABC_1_1Addressee.html#a2eb7d78ead23236a1bd80d9f0f432371" title="Return list of all addresses.">addresses</a>;
<a name="l00054"></a>00054   <a class="codeRef" href="qvaluelist.html">Key::List</a> <a class="code" href="classKABC_1_1Addressee.html#a490f3ae84cc7a34e9d55379a9bb8f3bb" title="Return list of all keys.">keys</a>;
<a name="l00055"></a>00055   <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#ac9c082e4dd9773ed41d4f9c07ffb744c" title="Return list of all email addresses.">emails</a>;
<a name="l00056"></a>00056   <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#ac149550eaa9298bea4602b771315863f" title="Return list of all set categories.">categories</a>;
<a name="l00057"></a>00057   <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#a7aa0e3bc38e2c05adf0c11e9464defc4" title="Return value of custom entry, identified by app and entry name.">custom</a>;
<a name="l00058"></a>00058 
<a name="l00059"></a>00059   Resource *<a class="code" href="classKABC_1_1Addressee.html#af097d2c55ca1e8f3574e96eb675924a7" title="Return pointer to resource.">resource</a>;
<a name="l00060"></a>00060 
<a name="l00061"></a>00061   <span class="keywordtype">bool</span> empty    :1;
<a name="l00062"></a>00062   <span class="keywordtype">bool</span> <a class="code" href="classKABC_1_1Addressee.html#a7b3932cedddfb6e2db1d5e869277525b" title="Return whether the addressee is changed.">changed</a>  :1;
<a name="l00063"></a>00063 };
<a name="l00064"></a>00064 
<a name="l00065"></a>00065 Addressee::AddresseeData* Addressee::shared_null = 0;
<a name="l00066"></a>00066 
<a name="l00067"></a>00067 Addressee::AddresseeData* Addressee::makeSharedNull()
<a name="l00068"></a>00068 {
<a name="l00069"></a>00069   Addressee::shared_null = <span class="keyword">new</span> AddresseeData;
<a name="l00070"></a>00070   shared_null-&gt;_KShared_ref(); <span class="comment">//just in case (we should add KSD)</span>
<a name="l00071"></a>00071   shared_null-&gt;empty = <span class="keyword">true</span>;
<a name="l00072"></a>00072   shared_null-&gt;changed = <span class="keyword">false</span>;
<a name="l00073"></a>00073   shared_null-&gt;resource = 0;
<a name="l00074"></a>00074   <span class="keywordflow">return</span> shared_null;
<a name="l00075"></a>00075 }
<a name="l00076"></a>00076 
<a name="l00077"></a><a class="code" href="classKABC_1_1Addressee.html#a4d7ab33e0fc87409fab11cdf11170f92">00077</a> <a class="code" href="classKABC_1_1Addressee.html#a4d7ab33e0fc87409fab11cdf11170f92" title="Construct an empty address book entry.">Addressee::Addressee</a>()
<a name="l00078"></a>00078 {
<a name="l00079"></a>00079   mData = shared_null ? shared_null : makeSharedNull();
<a name="l00080"></a>00080 }
<a name="l00081"></a>00081 
<a name="l00082"></a>00082 Addressee::~Addressee()
<a name="l00083"></a>00083 {
<a name="l00084"></a>00084 }
<a name="l00085"></a>00085 
<a name="l00086"></a>00086 <a class="code" href="classKABC_1_1Addressee.html#a4d7ab33e0fc87409fab11cdf11170f92" title="Construct an empty address book entry.">Addressee::Addressee</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )
<a name="l00087"></a>00087 {
<a name="l00088"></a>00088   mData = a.mData;
<a name="l00089"></a>00089 }
<a name="l00090"></a>00090 
<a name="l00091"></a>00091 <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;Addressee::operator=( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )
<a name="l00092"></a>00092 {
<a name="l00093"></a>00093   <span class="keywordflow">if</span> ( <span class="keyword">this</span> == &amp;a )
<a name="l00094"></a>00094     <span class="keywordflow">return</span> (*<span class="keyword">this</span>);
<a name="l00095"></a>00095 
<a name="l00096"></a>00096   mData = a.mData;
<a name="l00097"></a>00097   <span class="keywordflow">return</span> (*<span class="keyword">this</span>);
<a name="l00098"></a>00098 }
<a name="l00099"></a>00099 
<a name="l00100"></a>00100 <span class="keywordtype">void</span> Addressee::detach()
<a name="l00101"></a>00101 {
<a name="l00102"></a>00102   <span class="keywordflow">if</span> ( mData.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKSharedPtr.html#a67ef345fe6c6b337c5f0f277fcb15164">data</a>() == shared_null ) {
<a name="l00103"></a>00103     mData = <span class="keyword">new</span> AddresseeData;
<a name="l00104"></a>00104     mData-&gt;empty = <span class="keyword">true</span>;
<a name="l00105"></a>00105     mData-&gt;changed = <span class="keyword">false</span>;
<a name="l00106"></a>00106     mData-&gt;resource = 0;
<a name="l00107"></a>00107     mData-&gt;uid = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKApplication.html#a7f764319574823a984e5246357fa6387">KApplication::randomString</a>( 10 );
<a name="l00108"></a>00108     <span class="keywordflow">return</span>;
<a name="l00109"></a>00109   } <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( mData.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKSharedPtr.html#a4dff560b7514aa1532ad269fcd0c4784">count</a>() == 1 ) <span class="keywordflow">return</span>;
<a name="l00110"></a>00110 
<a name="l00111"></a>00111   AddresseeData data = *mData;
<a name="l00112"></a>00112   mData = <span class="keyword">new</span> AddresseeData( data );
<a name="l00113"></a>00113 }
<a name="l00114"></a>00114 
<a name="l00115"></a>00115 <span class="keywordtype">bool</span> Addressee::operator==( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )<span class="keyword"> const</span>
<a name="l00116"></a>00116 <span class="keyword"></span>{
<a name="l00117"></a>00117   <span class="keywordflow">if</span> ( <a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">uid</a>() != a.<a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">uid</a>() ) {
<a name="l00118"></a>00118     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;uid differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00119"></a>00119     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00120"></a>00120   }
<a name="l00121"></a>00121   --EQUALSTEST--
<a name="l00122"></a>00122   <span class="keywordflow">if</span> ( ( mData-&gt;url.isValid() || a.mData-&gt;url.isValid() ) &amp;&amp;
<a name="l00123"></a>00123        ( mData-&gt;url != a.mData-&gt;url ) ) {
<a name="l00124"></a>00124     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;url differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00125"></a>00125     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00126"></a>00126   }
<a name="l00127"></a>00127   <span class="keywordflow">if</span> ( !listEquals( mData-&gt;phoneNumbers, a.mData-&gt;phoneNumbers ) ) {
<a name="l00128"></a>00128     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;phoneNumbers differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00129"></a>00129     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00130"></a>00130   }
<a name="l00131"></a>00131   <span class="keywordflow">if</span> ( !listEquals( mData-&gt;addresses, a.mData-&gt;addresses ) ) {
<a name="l00132"></a>00132     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;addresses differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00133"></a>00133     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00134"></a>00134   }
<a name="l00135"></a>00135   <span class="keywordflow">if</span> ( !listEquals( mData-&gt;keys, a.mData-&gt;keys ) ) {
<a name="l00136"></a>00136     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;keys differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00137"></a>00137     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00138"></a>00138   }
<a name="l00139"></a>00139   <span class="keywordflow">if</span> ( !emailsEquals( mData-&gt;emails, a.mData-&gt;emails ) ) {
<a name="l00140"></a>00140     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;emails differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00141"></a>00141     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00142"></a>00142   }
<a name="l00143"></a>00143   <span class="keywordflow">if</span> ( !listEquals( mData-&gt;categories, a.mData-&gt;categories ) ) {
<a name="l00144"></a>00144     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;categories differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00145"></a>00145     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00146"></a>00146   }
<a name="l00147"></a>00147   <span class="keywordflow">if</span> ( !listEquals( mData-&gt;custom, a.mData-&gt;custom ) ) {
<a name="l00148"></a>00148     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;custom differs&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00149"></a>00149     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00150"></a>00150   }
<a name="l00151"></a>00151 
<a name="l00152"></a>00152   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00153"></a>00153 }
<a name="l00154"></a>00154 
<a name="l00155"></a>00155 <span class="keywordtype">bool</span> Addressee::operator!=( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )<span class="keyword"> const</span>
<a name="l00156"></a>00156 <span class="keyword"></span>{
<a name="l00157"></a>00157   <span class="keywordflow">return</span> !( a == *this );
<a name="l00158"></a>00158 }
<a name="l00159"></a>00159 
<a name="l00160"></a><a class="code" href="classKABC_1_1Addressee.html#a2aa789a775e5a6f473c5a7550e027607">00160</a> <span class="keywordtype">bool</span> <a class="code" href="classKABC_1_1Addressee.html#a2aa789a775e5a6f473c5a7550e027607" title="Return, if the address book entry is empty.">Addressee::isEmpty</a>()<span class="keyword"> const</span>
<a name="l00161"></a>00161 <span class="keyword"></span>{
<a name="l00162"></a>00162   <span class="keywordflow">return</span> mData-&gt;empty;
<a name="l00163"></a>00163 }
<a name="l00164"></a>00164 
<a name="l00165"></a><a class="code" href="classKABC_1_1Addressee.html#aeb8deb75da6ace715c53dd86b91c154c">00165</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#aeb8deb75da6ace715c53dd86b91c154c" title="Set unique identifier.">Addressee::setUid</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">id</span> )
<a name="l00166"></a>00166 {
<a name="l00167"></a>00167   <span class="keywordflow">if</span> ( <span class="keywordtype">id</span> == mData-&gt;uid ) <span class="keywordflow">return</span>;
<a name="l00168"></a>00168   detach();
<a name="l00169"></a>00169   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00170"></a>00170   mData-&gt;uid = id;
<a name="l00171"></a>00171 }
<a name="l00172"></a>00172 
<a name="l00173"></a><a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12">00173</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">Addressee::uid</a>()<span class="keyword"> const</span>
<a name="l00174"></a>00174 <span class="keyword"></span>{
<a name="l00175"></a>00175   <span class="keywordflow">return</span> mData-&gt;uid;
<a name="l00176"></a>00176 }
<a name="l00177"></a>00177 
<a name="l00178"></a><a class="code" href="classKABC_1_1Addressee.html#a631b8c1944c009c6aa25a0b3b722be1e">00178</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#a631b8c1944c009c6aa25a0b3b722be1e" title="Return translated label for uid field.">Addressee::uidLabel</a>()
<a name="l00179"></a>00179 {
<a name="l00180"></a>00180   <span class="keywordflow">return</span> i18n(<span class="stringliteral">&quot;Unique Identifier&quot;</span>);
<a name="l00181"></a>00181 }
<a name="l00182"></a>00182 
<a name="l00183"></a>00183 --DEFINITIONS--
<a name="l00184"></a>00184 
<a name="l00185"></a><a class="code" href="classKABC_1_1Addressee.html#ae42452adc6a37cebadaed20102eacdc6">00185</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#ae42452adc6a37cebadaed20102eacdc6" title="Set name fields by parsing the given string and trying to associate the parts of the string with acco...">Addressee::setNameFromString</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;s )
<a name="l00186"></a>00186 {
<a name="l00187"></a>00187   <a class="codeRef" href="qstring.html">QString</a> str = s;
<a name="l00188"></a>00188   <span class="comment">//remove enclosing quotes from string</span>
<a name="l00189"></a>00189   <span class="keywordflow">if</span> ( str.<a class="codeRef" href="qstring.html#length">length</a>() &gt; 1  &amp;&amp; s[ 0 ] == <span class="charliteral">&#39;&quot;&#39;</span> &amp;&amp; s[ s.<a class="codeRef" href="qstring.html#length">length</a>() - 1 ] == <span class="charliteral">&#39;&quot;&#39;</span> )
<a name="l00190"></a>00190     str = s.<a class="codeRef" href="qstring.html#mid">mid</a>( 1, s.<a class="codeRef" href="qstring.html#length">length</a>() - 2 );
<a name="l00191"></a>00191 
<a name="l00192"></a>00192   setFormattedName( str );
<a name="l00193"></a>00193   setName( str );
<a name="l00194"></a>00194 
<a name="l00195"></a>00195   <span class="comment">// clear all name parts</span>
<a name="l00196"></a>00196   setPrefix( QString::null );
<a name="l00197"></a>00197   setGivenName( QString::null );
<a name="l00198"></a>00198   setAdditionalName( QString::null );
<a name="l00199"></a>00199   setFamilyName( QString::null );
<a name="l00200"></a>00200   setSuffix( QString::null );
<a name="l00201"></a>00201 
<a name="l00202"></a>00202   <span class="keywordflow">if</span> ( str.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00203"></a>00203     <span class="keywordflow">return</span>;
<a name="l00204"></a>00204 
<a name="l00205"></a>00205   <a class="codeRef" href="qstring.html">QString</a> spaceStr = <span class="stringliteral">&quot; &quot;</span>;
<a name="l00206"></a>00206   <a class="codeRef" href="qstring.html">QString</a> emptyStr = <span class="stringliteral">&quot;&quot;</span>;
<a name="l00207"></a>00207   AddresseeHelper *helper = AddresseeHelper::self();
<a name="l00208"></a>00208 
<a name="l00209"></a>00209   <span class="keywordtype">int</span> i = str.<a class="codeRef" href="qstring.html#find">find</a>( <span class="charliteral">&#39;,&#39;</span> );
<a name="l00210"></a>00210   <span class="keywordflow">if</span>( i &lt; 0 ) {
<a name="l00211"></a>00211     <a class="codeRef" href="qstringlist.html">QStringList</a> parts = <a class="codeRef" href="qstringlist.html#split">QStringList::split</a>( spaceStr, str );
<a name="l00212"></a>00212     <span class="keywordtype">int</span> leftOffset = 0;
<a name="l00213"></a>00213     <span class="keywordtype">int</span> rightOffset = parts.count() - 1;
<a name="l00214"></a>00214 
<a name="l00215"></a>00215     <a class="codeRef" href="qstring.html">QString</a> suffix;
<a name="l00216"></a>00216     <span class="keywordflow">while</span> ( rightOffset &gt;= 0 ) {
<a name="l00217"></a>00217       <span class="keywordflow">if</span> ( helper-&gt;containsSuffix( parts[ rightOffset ] ) ) {
<a name="l00218"></a>00218         suffix.<a class="codeRef" href="qstring.html#prepend">prepend</a>(parts[ rightOffset ] + (suffix.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr));
<a name="l00219"></a>00219         rightOffset--;
<a name="l00220"></a>00220       } <span class="keywordflow">else</span>
<a name="l00221"></a>00221         <span class="keywordflow">break</span>;
<a name="l00222"></a>00222     }
<a name="l00223"></a>00223     setSuffix( suffix );
<a name="l00224"></a>00224 
<a name="l00225"></a>00225     <span class="keywordflow">if</span> ( rightOffset &lt; 0 )
<a name="l00226"></a>00226       <span class="keywordflow">return</span>;
<a name="l00227"></a>00227 
<a name="l00228"></a>00228     <a class="codeRef" href="qstringlist.html">QStringList</a> inclusionList;
<a name="l00229"></a>00229     <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> n = 1; (rightOffset - n &gt;= 0) &amp;&amp; (n &lt; 4); ++n ) {
<a name="l00230"></a>00230       <span class="keywordflow">if</span> ( helper-&gt;containsPrefix( parts[ rightOffset - n ].lower() ) ) {
<a name="l00231"></a>00231         inclusionList.prepend( parts[ rightOffset - n ] );
<a name="l00232"></a>00232       } <span class="keywordflow">else</span>
<a name="l00233"></a>00233         <span class="keywordflow">break</span>;
<a name="l00234"></a>00234     }
<a name="l00235"></a>00235 
<a name="l00236"></a>00236     <span class="keywordflow">if</span> ( !inclusionList.isEmpty() ) {
<a name="l00237"></a>00237       setFamilyName( inclusionList.<a class="codeRef" href="qstringlist.html#join">join</a>( <span class="stringliteral">&quot; &quot;</span> ) + spaceStr + parts[ rightOffset ] );
<a name="l00238"></a>00238       rightOffset -= inclusionList.count();
<a name="l00239"></a>00239     } <span class="keywordflow">else</span> {
<a name="l00240"></a>00240       <span class="keywordflow">if</span> ( helper-&gt;tradeAsFamilyName() )
<a name="l00241"></a>00241         setFamilyName( parts[ rightOffset ] );
<a name="l00242"></a>00242       <span class="keywordflow">else</span>
<a name="l00243"></a>00243         setGivenName( parts[ rightOffset ] );
<a name="l00244"></a>00244     }
<a name="l00245"></a>00245 
<a name="l00246"></a>00246     <a class="codeRef" href="qstring.html">QString</a> prefix;
<a name="l00247"></a>00247     <span class="keywordflow">while</span> ( leftOffset &lt; rightOffset ) {
<a name="l00248"></a>00248       <span class="keywordflow">if</span> ( helper-&gt;containsTitle( parts[ leftOffset ] ) ) {
<a name="l00249"></a>00249         prefix.<a class="codeRef" href="qstring.html#append">append</a>( ( prefix.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr) + parts[ leftOffset ] );
<a name="l00250"></a>00250         leftOffset++;
<a name="l00251"></a>00251       } <span class="keywordflow">else</span>
<a name="l00252"></a>00252         <span class="keywordflow">break</span>;
<a name="l00253"></a>00253     }
<a name="l00254"></a>00254     setPrefix( prefix );
<a name="l00255"></a>00255 
<a name="l00256"></a>00256     <span class="keywordflow">if</span> ( leftOffset &lt; rightOffset ) {
<a name="l00257"></a>00257       setGivenName( parts[ leftOffset ] );
<a name="l00258"></a>00258       leftOffset++;
<a name="l00259"></a>00259     }
<a name="l00260"></a>00260 
<a name="l00261"></a>00261     <a class="codeRef" href="qstring.html">QString</a> additionalName;
<a name="l00262"></a>00262     <span class="keywordflow">while</span> ( leftOffset &lt; rightOffset ) {
<a name="l00263"></a>00263       additionalName.<a class="codeRef" href="qstring.html#append">append</a>( ( additionalName.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr) + parts[ leftOffset ] );
<a name="l00264"></a>00264       leftOffset++;
<a name="l00265"></a>00265     }
<a name="l00266"></a>00266     setAdditionalName( additionalName );
<a name="l00267"></a>00267   } <span class="keywordflow">else</span> {
<a name="l00268"></a>00268     <a class="codeRef" href="qstring.html">QString</a> part1 = str.<a class="codeRef" href="qstring.html#left">left</a>( i );
<a name="l00269"></a>00269     <a class="codeRef" href="qstring.html">QString</a> part2 = str.<a class="codeRef" href="qstring.html#mid">mid</a>( i + 1 );
<a name="l00270"></a>00270 
<a name="l00271"></a>00271     <a class="codeRef" href="qstringlist.html">QStringList</a> parts = <a class="codeRef" href="qstringlist.html#split">QStringList::split</a>( spaceStr, part1 );
<a name="l00272"></a>00272     <span class="keywordtype">int</span> leftOffset = 0;
<a name="l00273"></a>00273     <span class="keywordtype">int</span> rightOffset = parts.count() - 1;
<a name="l00274"></a>00274 
<a name="l00275"></a>00275     <span class="keywordflow">if</span> ( parts.count() &gt; 0 ) {
<a name="l00276"></a>00276 
<a name="l00277"></a>00277       <a class="codeRef" href="qstring.html">QString</a> suffix;
<a name="l00278"></a>00278       <span class="keywordflow">while</span> ( rightOffset &gt;= 0 ) {
<a name="l00279"></a>00279         <span class="keywordflow">if</span> ( helper-&gt;containsSuffix( parts[ rightOffset ] ) ) {
<a name="l00280"></a>00280           suffix.<a class="codeRef" href="qstring.html#prepend">prepend</a>(parts[ rightOffset ] + (suffix.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr));
<a name="l00281"></a>00281           rightOffset--;
<a name="l00282"></a>00282         } <span class="keywordflow">else</span>
<a name="l00283"></a>00283           <span class="keywordflow">break</span>;
<a name="l00284"></a>00284       }
<a name="l00285"></a>00285       setSuffix( suffix );
<a name="l00286"></a>00286 
<a name="l00287"></a>00287       <span class="keywordflow">if</span> ( rightOffset - 1 &gt;= 0 &amp;&amp; helper-&gt;containsPrefix( parts[ rightOffset - 1 ].lower() ) ) {
<a name="l00288"></a>00288         setFamilyName( parts[ rightOffset - 1 ] + spaceStr + parts[ rightOffset ] );
<a name="l00289"></a>00289         rightOffset--;
<a name="l00290"></a>00290       } <span class="keywordflow">else</span>
<a name="l00291"></a>00291         setFamilyName( parts[ rightOffset ] );
<a name="l00292"></a>00292 
<a name="l00293"></a>00293       <a class="codeRef" href="qstring.html">QString</a> prefix;
<a name="l00294"></a>00294       <span class="keywordflow">while</span> ( leftOffset &lt; rightOffset ) {
<a name="l00295"></a>00295         <span class="keywordflow">if</span> ( helper-&gt;containsTitle( parts[ leftOffset ] ) ) {
<a name="l00296"></a>00296           prefix.<a class="codeRef" href="qstring.html#append">append</a>( ( prefix.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr) + parts[ leftOffset ] );
<a name="l00297"></a>00297           leftOffset++;
<a name="l00298"></a>00298         } <span class="keywordflow">else</span>
<a name="l00299"></a>00299           <span class="keywordflow">break</span>;
<a name="l00300"></a>00300       }
<a name="l00301"></a>00301     } <span class="keywordflow">else</span> {
<a name="l00302"></a>00302       setPrefix( <span class="stringliteral">&quot;&quot;</span> );
<a name="l00303"></a>00303       setFamilyName( <span class="stringliteral">&quot;&quot;</span> );
<a name="l00304"></a>00304       setSuffix( <span class="stringliteral">&quot;&quot;</span> );
<a name="l00305"></a>00305     }
<a name="l00306"></a>00306 
<a name="l00307"></a>00307     parts = <a class="codeRef" href="qstringlist.html#split">QStringList::split</a>( spaceStr, part2 );
<a name="l00308"></a>00308 
<a name="l00309"></a>00309     leftOffset = 0;
<a name="l00310"></a>00310     rightOffset = parts.count();
<a name="l00311"></a>00311 
<a name="l00312"></a>00312     <span class="keywordflow">if</span> ( parts.count() &gt; 0 ) {
<a name="l00313"></a>00313 
<a name="l00314"></a>00314       <a class="codeRef" href="qstring.html">QString</a> prefix;
<a name="l00315"></a>00315       <span class="keywordflow">while</span> ( leftOffset &lt; rightOffset ) {
<a name="l00316"></a>00316         <span class="keywordflow">if</span> ( helper-&gt;containsTitle( parts[ leftOffset ] ) ) {
<a name="l00317"></a>00317           prefix.<a class="codeRef" href="qstring.html#append">append</a>( ( prefix.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr) + parts[ leftOffset ] );
<a name="l00318"></a>00318           leftOffset++;
<a name="l00319"></a>00319         } <span class="keywordflow">else</span>
<a name="l00320"></a>00320           <span class="keywordflow">break</span>;
<a name="l00321"></a>00321       }
<a name="l00322"></a>00322       setPrefix( prefix );
<a name="l00323"></a>00323 
<a name="l00324"></a>00324       <span class="keywordflow">if</span> ( leftOffset &lt; rightOffset ) {
<a name="l00325"></a>00325         setGivenName( parts[ leftOffset ] );
<a name="l00326"></a>00326         leftOffset++;
<a name="l00327"></a>00327       }
<a name="l00328"></a>00328 
<a name="l00329"></a>00329       <a class="codeRef" href="qstring.html">QString</a> additionalName;
<a name="l00330"></a>00330       <span class="keywordflow">while</span> ( leftOffset &lt; rightOffset ) {
<a name="l00331"></a>00331         additionalName.<a class="codeRef" href="qstring.html#append">append</a>( ( additionalName.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ? emptyStr : spaceStr) + parts[ leftOffset ] );
<a name="l00332"></a>00332         leftOffset++;
<a name="l00333"></a>00333       }
<a name="l00334"></a>00334       setAdditionalName( additionalName );
<a name="l00335"></a>00335     } <span class="keywordflow">else</span> {
<a name="l00336"></a>00336       setGivenName( <span class="stringliteral">&quot;&quot;</span> );
<a name="l00337"></a>00337       setAdditionalName( <span class="stringliteral">&quot;&quot;</span> );
<a name="l00338"></a>00338     }
<a name="l00339"></a>00339   }
<a name="l00340"></a>00340 }
<a name="l00341"></a>00341 
<a name="l00342"></a><a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a">00342</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a" title="Return the name of the addressee.">Addressee::realName</a>()<span class="keyword"> const</span>
<a name="l00343"></a>00343 <span class="keyword"></span>{
<a name="l00344"></a>00344   <a class="codeRef" href="qstring.html">QString</a> n( formattedName() );
<a name="l00345"></a>00345   <span class="keywordflow">if</span> ( !n.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00346"></a>00346     <span class="keywordflow">return</span> n;
<a name="l00347"></a>00347 
<a name="l00348"></a>00348   n = <a class="code" href="classKABC_1_1Addressee.html#a0ed85527d6496b81bec200c2578aaade" title="Return the name that consists of all name parts.">assembledName</a>();
<a name="l00349"></a>00349   <span class="keywordflow">if</span> ( !n.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00350"></a>00350     <span class="keywordflow">return</span> n;
<a name="l00351"></a>00351 
<a name="l00352"></a>00352   n = name();
<a name="l00353"></a>00353   <span class="keywordflow">if</span> ( !n.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00354"></a>00354     <span class="keywordflow">return</span> n;
<a name="l00355"></a>00355 
<a name="l00356"></a>00356   <span class="keywordflow">return</span> organization();
<a name="l00357"></a>00357 }
<a name="l00358"></a>00358 
<a name="l00359"></a><a class="code" href="classKABC_1_1Addressee.html#a0ed85527d6496b81bec200c2578aaade">00359</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#a0ed85527d6496b81bec200c2578aaade" title="Return the name that consists of all name parts.">Addressee::assembledName</a>()<span class="keyword"> const</span>
<a name="l00360"></a>00360 <span class="keyword"></span>{
<a name="l00361"></a>00361   <a class="codeRef" href="qstring.html">QString</a> name = prefix() + <span class="stringliteral">&quot; &quot;</span> + givenName() + <span class="stringliteral">&quot; &quot;</span> + additionalName() + <span class="stringliteral">&quot; &quot;</span> +
<a name="l00362"></a>00362               familyName() + <span class="stringliteral">&quot; &quot;</span> + suffix();
<a name="l00363"></a>00363 
<a name="l00364"></a>00364   <span class="keywordflow">return</span> name.<a class="codeRef" href="qstring.html#simplifyWhiteSpace">simplifyWhiteSpace</a>();
<a name="l00365"></a>00365 }
<a name="l00366"></a>00366 
<a name="l00367"></a><a class="code" href="classKABC_1_1Addressee.html#a531b053f66b538ce531bf6eb886da405">00367</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#a531b053f66b538ce531bf6eb886da405" title="Return email address including real name.">Addressee::fullEmail</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;email )<span class="keyword"> const</span>
<a name="l00368"></a>00368 <span class="keyword"></span>{
<a name="l00369"></a>00369   <a class="codeRef" href="qstring.html">QString</a> e;
<a name="l00370"></a>00370   <span class="keywordflow">if</span> ( email.<a class="codeRef" href="qstring.html#isNull">isNull</a>() ) {
<a name="l00371"></a>00371     e = <a class="code" href="classKABC_1_1Addressee.html#a72dad5934c5d340e2c339d2db70a3091" title="Return preferred email address.">preferredEmail</a>();
<a name="l00372"></a>00372   } <span class="keywordflow">else</span> {
<a name="l00373"></a>00373     e = email;
<a name="l00374"></a>00374   }
<a name="l00375"></a>00375   <span class="keywordflow">if</span> ( e.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) <span class="keywordflow">return</span> QString::null;
<a name="l00376"></a>00376 
<a name="l00377"></a>00377   <a class="codeRef" href="qstring.html">QString</a> text;
<a name="l00378"></a>00378   <span class="keywordflow">if</span> ( <a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a" title="Return the name of the addressee.">realName</a>().<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00379"></a>00379     text = e;
<a name="l00380"></a>00380   <span class="keywordflow">else</span> {
<a name="l00381"></a>00381     <a class="codeRef" href="qregexp.html">QRegExp</a> needQuotes( <span class="stringliteral">&quot;[^ 0-9A-Za-z\\x0080-\\xFFFF]&quot;</span> );
<a name="l00382"></a>00382     <span class="keywordflow">if</span> ( <a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a" title="Return the name of the addressee.">realName</a>().find( needQuotes ) != -1 ) {
<a name="l00383"></a>00383       <a class="codeRef" href="qstring.html">QString</a> name = <a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a" title="Return the name of the addressee.">realName</a>();
<a name="l00384"></a>00384       name.<a class="codeRef" href="qstring.html#replace">replace</a>( <span class="stringliteral">&quot;\&quot;&quot;</span>, <span class="stringliteral">&quot;\\\&quot;&quot;</span> );
<a name="l00385"></a>00385       text = <span class="stringliteral">&quot;\&quot;&quot;</span> + name + <span class="stringliteral">&quot;\&quot; &lt;&quot;</span> + e + <span class="stringliteral">&quot;&gt;&quot;</span>;
<a name="l00386"></a>00386     } <span class="keywordflow">else</span>
<a name="l00387"></a>00387       text = <a class="code" href="classKABC_1_1Addressee.html#adccf8ec301048cf6961b3a7b9fe44d3a" title="Return the name of the addressee.">realName</a>() + <span class="stringliteral">&quot; &lt;&quot;</span> + e + <span class="stringliteral">&quot;&gt;&quot;</span>;
<a name="l00388"></a>00388   }
<a name="l00389"></a>00389 
<a name="l00390"></a>00390   <span class="keywordflow">return</span> text;
<a name="l00391"></a>00391 }
<a name="l00392"></a>00392 
<a name="l00393"></a><a class="code" href="classKABC_1_1Addressee.html#a7c60c92b47551cf8628f3fe796d15100">00393</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a7c60c92b47551cf8628f3fe796d15100" title="Insert an email address.">Addressee::insertEmail</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;email, <span class="keywordtype">bool</span> preferred )
<a name="l00394"></a>00394 {
<a name="l00395"></a>00395   <span class="keywordflow">if</span> ( email.<a class="codeRef" href="qstring.html#simplifyWhiteSpace">simplifyWhiteSpace</a>().isEmpty() )
<a name="l00396"></a>00396     <span class="keywordflow">return</span>;
<a name="l00397"></a>00397 
<a name="l00398"></a>00398   detach();
<a name="l00399"></a>00399   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00400"></a>00400 
<a name="l00401"></a>00401   QStringList::Iterator it = mData-&gt;emails.find( email );
<a name="l00402"></a>00402 
<a name="l00403"></a>00403   <span class="keywordflow">if</span> ( it != mData-&gt;emails.end() ) {
<a name="l00404"></a>00404     <span class="keywordflow">if</span> ( !preferred || it == mData-&gt;emails.begin() ) <span class="keywordflow">return</span>;
<a name="l00405"></a>00405     mData-&gt;emails.remove( it );
<a name="l00406"></a>00406     mData-&gt;emails.prepend( email );
<a name="l00407"></a>00407   } <span class="keywordflow">else</span> {
<a name="l00408"></a>00408     <span class="keywordflow">if</span> ( preferred ) {
<a name="l00409"></a>00409       mData-&gt;emails.prepend( email );
<a name="l00410"></a>00410     } <span class="keywordflow">else</span> {
<a name="l00411"></a>00411       mData-&gt;emails.append( email );
<a name="l00412"></a>00412     }
<a name="l00413"></a>00413   }
<a name="l00414"></a>00414 }
<a name="l00415"></a>00415 
<a name="l00416"></a><a class="code" href="classKABC_1_1Addressee.html#a46009d7a89d77510ba4df773657093d7">00416</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a46009d7a89d77510ba4df773657093d7" title="Remove email address.">Addressee::removeEmail</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;email )
<a name="l00417"></a>00417 {
<a name="l00418"></a>00418   detach();
<a name="l00419"></a>00419 
<a name="l00420"></a>00420   QStringList::Iterator it = mData-&gt;emails.find( email );
<a name="l00421"></a>00421   <span class="keywordflow">if</span> ( it == mData-&gt;emails.end() ) <span class="keywordflow">return</span>;
<a name="l00422"></a>00422 
<a name="l00423"></a>00423   mData-&gt;emails.remove( it );
<a name="l00424"></a>00424 }
<a name="l00425"></a>00425 
<a name="l00426"></a><a class="code" href="classKABC_1_1Addressee.html#a72dad5934c5d340e2c339d2db70a3091">00426</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#a72dad5934c5d340e2c339d2db70a3091" title="Return preferred email address.">Addressee::preferredEmail</a>()<span class="keyword"> const</span>
<a name="l00427"></a>00427 <span class="keyword"></span>{
<a name="l00428"></a>00428   <span class="keywordflow">if</span> ( mData-&gt;emails.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKSharedPtr.html#a4dff560b7514aa1532ad269fcd0c4784">count</a>() == 0 ) <span class="keywordflow">return</span> QString::null;
<a name="l00429"></a>00429   <span class="keywordflow">else</span> <span class="keywordflow">return</span> mData-&gt;emails.first();
<a name="l00430"></a>00430 }
<a name="l00431"></a>00431 
<a name="l00432"></a><a class="code" href="classKABC_1_1Addressee.html#ac9c082e4dd9773ed41d4f9c07ffb744c">00432</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#ac9c082e4dd9773ed41d4f9c07ffb744c" title="Return list of all email addresses.">Addressee::emails</a>()<span class="keyword"> const</span>
<a name="l00433"></a>00433 <span class="keyword"></span>{
<a name="l00434"></a>00434   <span class="keywordflow">return</span> mData-&gt;emails;
<a name="l00435"></a>00435 }
<a name="l00436"></a><a class="code" href="classKABC_1_1Addressee.html#a73cafb82a1308fac4fa1ea37a471a568">00436</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a73cafb82a1308fac4fa1ea37a471a568" title="Set the emails to list.">Addressee::setEmails</a>( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a>&amp; emails ) {
<a name="l00437"></a>00437   detach();
<a name="l00438"></a>00438 
<a name="l00439"></a>00439   mData-&gt;emails = <a class="code" href="classKABC_1_1Addressee.html#ac9c082e4dd9773ed41d4f9c07ffb744c" title="Return list of all email addresses.">emails</a>;
<a name="l00440"></a>00440 }
<a name="l00441"></a><a class="code" href="classKABC_1_1Addressee.html#a2880e9be1777eba375dff2fb13766933">00441</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a2880e9be1777eba375dff2fb13766933" title="Insert a phone number.">Addressee::insertPhoneNumber</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a> &amp;phoneNumber )
<a name="l00442"></a>00442 {
<a name="l00443"></a>00443   detach();
<a name="l00444"></a>00444   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00445"></a>00445 
<a name="l00446"></a>00446   <a class="codeRef" href="qvaluelist.html#Iterator">PhoneNumber::List::Iterator</a> it;
<a name="l00447"></a>00447   <span class="keywordflow">for</span>( it = mData-&gt;phoneNumbers.begin(); it != mData-&gt;phoneNumbers.end(); ++it ) {
<a name="l00448"></a>00448     <span class="keywordflow">if</span> ( (*it).id() == phoneNumber.<a class="code" href="classKABC_1_1PhoneNumber.html#a0a7489248bc4c63bb0962bc98d523ce4" title="Returns the unique identifier.">id</a>() ) {
<a name="l00449"></a>00449       *it = <a class="code" href="classKABC_1_1Addressee.html#a9cb7d81ee5205786dad716a392c2cc30" title="Return phone number, which matches the given type.">phoneNumber</a>;
<a name="l00450"></a>00450       <span class="keywordflow">return</span>;
<a name="l00451"></a>00451     }
<a name="l00452"></a>00452   }
<a name="l00453"></a>00453   <span class="keywordflow">if</span> ( !phoneNumber.<a class="code" href="classKABC_1_1PhoneNumber.html#aa1d90c25e1cf7e1a4e6d8388ab788a25" title="Returns the number.">number</a>().<a class="codeRef" href="qstring.html#simplifyWhiteSpace">simplifyWhiteSpace</a>().isEmpty() )
<a name="l00454"></a>00454     mData-&gt;phoneNumbers.append( phoneNumber );
<a name="l00455"></a>00455 }
<a name="l00456"></a>00456 
<a name="l00457"></a><a class="code" href="classKABC_1_1Addressee.html#a1ea5ef3b5c012647918dc180f9ca16e8">00457</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a1ea5ef3b5c012647918dc180f9ca16e8" title="Remove phone number.">Addressee::removePhoneNumber</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a> &amp;phoneNumber )
<a name="l00458"></a>00458 {
<a name="l00459"></a>00459   detach();
<a name="l00460"></a>00460 
<a name="l00461"></a>00461   <a class="codeRef" href="qvaluelist.html#Iterator">PhoneNumber::List::Iterator</a> it;
<a name="l00462"></a>00462   <span class="keywordflow">for</span>( it = mData-&gt;phoneNumbers.begin(); it != mData-&gt;phoneNumbers.end(); ++it ) {
<a name="l00463"></a>00463     <span class="keywordflow">if</span> ( (*it).id() == phoneNumber.<a class="code" href="classKABC_1_1PhoneNumber.html#a0a7489248bc4c63bb0962bc98d523ce4" title="Returns the unique identifier.">id</a>() ) {
<a name="l00464"></a>00464       mData-&gt;phoneNumbers.remove( it );
<a name="l00465"></a>00465       <span class="keywordflow">return</span>;
<a name="l00466"></a>00466     }
<a name="l00467"></a>00467   }
<a name="l00468"></a>00468 }
<a name="l00469"></a>00469 
<a name="l00470"></a><a class="code" href="classKABC_1_1Addressee.html#a9cb7d81ee5205786dad716a392c2cc30">00470</a> <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a> <a class="code" href="classKABC_1_1Addressee.html#a9cb7d81ee5205786dad716a392c2cc30" title="Return phone number, which matches the given type.">Addressee::phoneNumber</a>( <span class="keywordtype">int</span> type )<span class="keyword"> const</span>
<a name="l00471"></a>00471 <span class="keyword"></span>{
<a name="l00472"></a>00472   <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a> <a class="code" href="classKABC_1_1Addressee.html#a9cb7d81ee5205786dad716a392c2cc30" title="Return phone number, which matches the given type.">phoneNumber</a>( <span class="stringliteral">&quot;&quot;</span>, type );
<a name="l00473"></a>00473   <a class="codeRef" href="qvaluelist.html#ConstIterator">PhoneNumber::List::ConstIterator</a> it;
<a name="l00474"></a>00474   <span class="keywordflow">for</span>( it = mData-&gt;phoneNumbers.constBegin(); it != mData-&gt;phoneNumbers.constEnd(); ++it ) {
<a name="l00475"></a>00475     <span class="keywordflow">if</span> ( matchBinaryPattern( (*it).type(), type ) ) {
<a name="l00476"></a>00476       <span class="keywordflow">if</span> ( (*it).type() &amp; PhoneNumber::Pref )
<a name="l00477"></a>00477         <span class="keywordflow">return</span> (*it);
<a name="l00478"></a>00478       <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( phoneNumber.<a class="code" href="classKABC_1_1PhoneNumber.html#aa1d90c25e1cf7e1a4e6d8388ab788a25" title="Returns the number.">number</a>().<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00479"></a>00479         phoneNumber = (*it);
<a name="l00480"></a>00480     }
<a name="l00481"></a>00481   }
<a name="l00482"></a>00482 
<a name="l00483"></a>00483   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1Addressee.html#a9cb7d81ee5205786dad716a392c2cc30" title="Return phone number, which matches the given type.">phoneNumber</a>;
<a name="l00484"></a>00484 }
<a name="l00485"></a>00485 
<a name="l00486"></a><a class="code" href="classKABC_1_1Addressee.html#a3f01378d745b242c39cb686b2be1153f">00486</a> <a class="codeRef" href="qvaluelist.html">PhoneNumber::List</a> <a class="code" href="classKABC_1_1Addressee.html#a3f01378d745b242c39cb686b2be1153f" title="Return list of all phone numbers.">Addressee::phoneNumbers</a>()<span class="keyword"> const</span>
<a name="l00487"></a>00487 <span class="keyword"></span>{
<a name="l00488"></a>00488   <span class="keywordflow">return</span> mData-&gt;phoneNumbers;
<a name="l00489"></a>00489 }
<a name="l00490"></a>00490 
<a name="l00491"></a><a class="code" href="classKABC_1_1Addressee.html#a733c89d732f110ad44e8487e267bdebb">00491</a> <a class="codeRef" href="qvaluelist.html">PhoneNumber::List</a> <a class="code" href="classKABC_1_1Addressee.html#a3f01378d745b242c39cb686b2be1153f" title="Return list of all phone numbers.">Addressee::phoneNumbers</a>( <span class="keywordtype">int</span> type )<span class="keyword"> const</span>
<a name="l00492"></a>00492 <span class="keyword"></span>{
<a name="l00493"></a>00493   <a class="codeRef" href="qvaluelist.html">PhoneNumber::List</a> list;
<a name="l00494"></a>00494 
<a name="l00495"></a>00495   <a class="codeRef" href="qvaluelist.html#ConstIterator">PhoneNumber::List::ConstIterator</a> it;
<a name="l00496"></a>00496   <span class="keywordflow">for</span>( it = mData-&gt;phoneNumbers.constBegin(); it != mData-&gt;phoneNumbers.constEnd(); ++it ) {
<a name="l00497"></a>00497     <span class="keywordflow">if</span> ( matchBinaryPattern( (*it).type(), type ) ) {
<a name="l00498"></a>00498       list.<a class="codeRef" href="qvaluelist.html#append">append</a>( *it );
<a name="l00499"></a>00499     }
<a name="l00500"></a>00500   }
<a name="l00501"></a>00501   <span class="keywordflow">return</span> list;
<a name="l00502"></a>00502 }
<a name="l00503"></a>00503 
<a name="l00504"></a><a class="code" href="classKABC_1_1Addressee.html#a5e6674df5554507ef8c0e33576dfbcd4">00504</a> <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a> <a class="code" href="classKABC_1_1Addressee.html#a5e6674df5554507ef8c0e33576dfbcd4" title="Return phone number with the given id.">Addressee::findPhoneNumber</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">id</span> )<span class="keyword"> const</span>
<a name="l00505"></a>00505 <span class="keyword"></span>{
<a name="l00506"></a>00506   <a class="codeRef" href="qvaluelist.html#ConstIterator">PhoneNumber::List::ConstIterator</a> it;
<a name="l00507"></a>00507   <span class="keywordflow">for</span>( it = mData-&gt;phoneNumbers.constBegin(); it != mData-&gt;phoneNumbers.constEnd(); ++it ) {
<a name="l00508"></a>00508     <span class="keywordflow">if</span> ( (*it).id() == id ) {
<a name="l00509"></a>00509       <span class="keywordflow">return</span> *it;
<a name="l00510"></a>00510     }
<a name="l00511"></a>00511   }
<a name="l00512"></a>00512   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1PhoneNumber.html" title="Phonenumber information.">PhoneNumber</a>();
<a name="l00513"></a>00513 }
<a name="l00514"></a>00514 
<a name="l00515"></a><a class="code" href="classKABC_1_1Addressee.html#ac2bf62121b5b47ae3d593a4b620121b9">00515</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#ac2bf62121b5b47ae3d593a4b620121b9" title="Insert a key.">Addressee::insertKey</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a> &amp;key )
<a name="l00516"></a>00516 {
<a name="l00517"></a>00517   detach();
<a name="l00518"></a>00518   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00519"></a>00519 
<a name="l00520"></a>00520   <a class="codeRef" href="qvaluelist.html#Iterator">Key::List::Iterator</a> it;
<a name="l00521"></a>00521   <span class="keywordflow">for</span>( it = mData-&gt;keys.begin(); it != mData-&gt;keys.end(); ++it ) {
<a name="l00522"></a>00522     <span class="keywordflow">if</span> ( (*it).id() == key.<a class="code" href="classKABC_1_1Key.html#a3d7d9f77c04a3a968a9659478b350ff4" title="Returns the unique identifier.">id</a>() ) {
<a name="l00523"></a>00523       *it = <a class="code" href="classKABC_1_1Addressee.html#a19bd1539308b0fefe3e28385e6ca97c5" title="Return key, which matches the given type.">key</a>;
<a name="l00524"></a>00524       <span class="keywordflow">return</span>;
<a name="l00525"></a>00525     }
<a name="l00526"></a>00526   }
<a name="l00527"></a>00527   mData-&gt;keys.append( key );
<a name="l00528"></a>00528 }
<a name="l00529"></a>00529 
<a name="l00530"></a><a class="code" href="classKABC_1_1Addressee.html#a05a544b076241c743befba9480610051">00530</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a05a544b076241c743befba9480610051" title="Remove a key.">Addressee::removeKey</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a> &amp;key )
<a name="l00531"></a>00531 {
<a name="l00532"></a>00532   detach();
<a name="l00533"></a>00533 
<a name="l00534"></a>00534   <a class="codeRef" href="qvaluelist.html#Iterator">Key::List::Iterator</a> it;
<a name="l00535"></a>00535   <span class="keywordflow">for</span>( it = mData-&gt;keys.begin(); it != mData-&gt;keys.end(); ++it ) {
<a name="l00536"></a>00536     <span class="keywordflow">if</span> ( (*it).id() == key.<a class="code" href="classKABC_1_1Key.html#a3d7d9f77c04a3a968a9659478b350ff4" title="Returns the unique identifier.">id</a>() ) {
<a name="l00537"></a>00537       mData-&gt;keys.remove( key );
<a name="l00538"></a>00538       <span class="keywordflow">return</span>;
<a name="l00539"></a>00539     }
<a name="l00540"></a>00540   }
<a name="l00541"></a>00541 }
<a name="l00542"></a>00542 
<a name="l00543"></a><a class="code" href="classKABC_1_1Addressee.html#a19bd1539308b0fefe3e28385e6ca97c5">00543</a> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a> <a class="code" href="classKABC_1_1Addressee.html#a19bd1539308b0fefe3e28385e6ca97c5" title="Return key, which matches the given type.">Addressee::key</a>( <span class="keywordtype">int</span> type, <a class="codeRef" href="qstring.html">QString</a> customTypeString )<span class="keyword"> const</span>
<a name="l00544"></a>00544 <span class="keyword"></span>{
<a name="l00545"></a>00545   <a class="codeRef" href="qvaluelist.html#ConstIterator">Key::List::ConstIterator</a> it;
<a name="l00546"></a>00546   <span class="keywordflow">for</span>( it = mData-&gt;keys.constBegin(); it != mData-&gt;keys.constEnd(); ++it ) {
<a name="l00547"></a>00547     <span class="keywordflow">if</span> ( (*it).type() == type ) {
<a name="l00548"></a>00548       <span class="keywordflow">if</span> ( type == Key::Custom ) {
<a name="l00549"></a>00549         <span class="keywordflow">if</span> ( customTypeString.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00550"></a>00550           <span class="keywordflow">return</span> *it;
<a name="l00551"></a>00551         } <span class="keywordflow">else</span> {
<a name="l00552"></a>00552           <span class="keywordflow">if</span> ( (*it).customTypeString() == customTypeString )
<a name="l00553"></a>00553             <span class="keywordflow">return</span> (*it);
<a name="l00554"></a>00554         }
<a name="l00555"></a>00555       } <span class="keywordflow">else</span> {
<a name="l00556"></a>00556         <span class="keywordflow">return</span> *it;
<a name="l00557"></a>00557       }
<a name="l00558"></a>00558     }
<a name="l00559"></a>00559   }
<a name="l00560"></a>00560   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a>( <a class="codeRef" href="qstring.html">QString</a>(), type );
<a name="l00561"></a>00561 }
<a name="l00562"></a>00562 
<a name="l00563"></a><a class="code" href="classKABC_1_1Addressee.html#a26c707633e5377d0270a5ef59a59faea">00563</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a26c707633e5377d0270a5ef59a59faea" title="Set the list of keys.">Addressee::setKeys</a>( <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">Key::List</a>&amp; list )
<a name="l00564"></a>00564 {
<a name="l00565"></a>00565   detach();
<a name="l00566"></a>00566   mData-&gt;keys = list;
<a name="l00567"></a>00567 }
<a name="l00568"></a>00568 
<a name="l00569"></a><a class="code" href="classKABC_1_1Addressee.html#a490f3ae84cc7a34e9d55379a9bb8f3bb">00569</a> <a class="codeRef" href="qvaluelist.html">Key::List</a> <a class="code" href="classKABC_1_1Addressee.html#a490f3ae84cc7a34e9d55379a9bb8f3bb" title="Return list of all keys.">Addressee::keys</a>()<span class="keyword"> const</span>
<a name="l00570"></a>00570 <span class="keyword"></span>{
<a name="l00571"></a>00571   <span class="keywordflow">return</span> mData-&gt;keys;
<a name="l00572"></a>00572 }
<a name="l00573"></a>00573 
<a name="l00574"></a><a class="code" href="classKABC_1_1Addressee.html#a9c513627452c2446514c0f51d7d9f982">00574</a> <a class="codeRef" href="qvaluelist.html">Key::List</a> <a class="code" href="classKABC_1_1Addressee.html#a490f3ae84cc7a34e9d55379a9bb8f3bb" title="Return list of all keys.">Addressee::keys</a>( <span class="keywordtype">int</span> type, <a class="codeRef" href="qstring.html">QString</a> customTypeString )<span class="keyword"> const</span>
<a name="l00575"></a>00575 <span class="keyword"></span>{
<a name="l00576"></a>00576   <a class="codeRef" href="qvaluelist.html">Key::List</a> list;
<a name="l00577"></a>00577 
<a name="l00578"></a>00578   <a class="codeRef" href="qvaluelist.html#ConstIterator">Key::List::ConstIterator</a> it;
<a name="l00579"></a>00579   <span class="keywordflow">for</span>( it = mData-&gt;keys.constBegin(); it != mData-&gt;keys.constEnd(); ++it ) {
<a name="l00580"></a>00580     <span class="keywordflow">if</span> ( (*it).type() == type ) {
<a name="l00581"></a>00581       <span class="keywordflow">if</span> ( type == Key::Custom ) {
<a name="l00582"></a>00582         <span class="keywordflow">if</span> ( customTypeString.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00583"></a>00583           list.<a class="codeRef" href="qvaluelist.html#append">append</a>( *it );
<a name="l00584"></a>00584         } <span class="keywordflow">else</span> {
<a name="l00585"></a>00585           <span class="keywordflow">if</span> ( (*it).customTypeString() == customTypeString )
<a name="l00586"></a>00586             list.<a class="codeRef" href="qvaluelist.html#append">append</a>( *it );
<a name="l00587"></a>00587         }
<a name="l00588"></a>00588       } <span class="keywordflow">else</span> {
<a name="l00589"></a>00589         list.<a class="codeRef" href="qvaluelist.html#append">append</a>( *it );
<a name="l00590"></a>00590       }
<a name="l00591"></a>00591     }
<a name="l00592"></a>00592   }
<a name="l00593"></a>00593   <span class="keywordflow">return</span> list;
<a name="l00594"></a>00594 }
<a name="l00595"></a>00595 
<a name="l00596"></a><a class="code" href="classKABC_1_1Addressee.html#a6f6ebbee37aab7fd0ce1575f3979cc4b">00596</a> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a> <a class="code" href="classKABC_1_1Addressee.html#a6f6ebbee37aab7fd0ce1575f3979cc4b" title="Return key with the given id.">Addressee::findKey</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">id</span> )<span class="keyword"> const</span>
<a name="l00597"></a>00597 <span class="keyword"></span>{
<a name="l00598"></a>00598   <a class="codeRef" href="qvaluelist.html#ConstIterator">Key::List::ConstIterator</a> it;
<a name="l00599"></a>00599   <span class="keywordflow">for</span>( it = mData-&gt;keys.constBegin(); it != mData-&gt;keys.constEnd(); ++it ) {
<a name="l00600"></a>00600     <span class="keywordflow">if</span> ( (*it).id() == id ) {
<a name="l00601"></a>00601       <span class="keywordflow">return</span> *it;
<a name="l00602"></a>00602     }
<a name="l00603"></a>00603   }
<a name="l00604"></a>00604   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1Key.html" title="A class to store an encryption key.">Key</a>();
<a name="l00605"></a>00605 }
<a name="l00606"></a>00606 
<a name="l00607"></a><a class="code" href="classKABC_1_1Addressee.html#af67c863527774db681afbd9ad75c9a98">00607</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#af67c863527774db681afbd9ad75c9a98" title="Returns string representation of the addressee.">Addressee::asString</a>()<span class="keyword"> const</span>
<a name="l00608"></a>00608 <span class="keyword"></span>{
<a name="l00609"></a>00609   <span class="keywordflow">return</span> <span class="stringliteral">&quot;Smith, agent Smith...&quot;</span>;
<a name="l00610"></a>00610 }
<a name="l00611"></a>00611 
<a name="l00612"></a><a class="code" href="classKABC_1_1Addressee.html#a4aba5884b6679b9a4ac72cca78c7109d">00612</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a4aba5884b6679b9a4ac72cca78c7109d" title="Debug output.">Addressee::dump</a>()<span class="keyword"> const</span>
<a name="l00613"></a>00613 <span class="keyword"></span>{
<a name="l00614"></a>00614   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;Addressee {&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00615"></a>00615 
<a name="l00616"></a>00616   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  Uid: &#39;&quot;</span> &lt;&lt; <a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">uid</a>() &lt;&lt; <span class="stringliteral">&quot;&#39;&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00617"></a>00617 
<a name="l00618"></a>00618   --DEBUG--
<a name="l00619"></a>00619 
<a name="l00620"></a>00620   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  Emails {&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00621"></a>00621   <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> e = <a class="code" href="classKABC_1_1Addressee.html#ac9c082e4dd9773ed41d4f9c07ffb744c" title="Return list of all email addresses.">emails</a>();
<a name="l00622"></a>00622   QStringList::ConstIterator it;
<a name="l00623"></a>00623   <span class="keywordflow">for</span>( it = e.begin(); it != e.end(); ++it ) {
<a name="l00624"></a>00624     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;    &quot;</span> &lt;&lt; (*it) &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00625"></a>00625   }
<a name="l00626"></a>00626   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  }&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00627"></a>00627 
<a name="l00628"></a>00628   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  PhoneNumbers {&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00629"></a>00629   <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">PhoneNumber::List</a> p = <a class="code" href="classKABC_1_1Addressee.html#a3f01378d745b242c39cb686b2be1153f" title="Return list of all phone numbers.">phoneNumbers</a>();
<a name="l00630"></a>00630   <a class="codeRef" href="qvaluelist.html#ConstIterator">PhoneNumber::List::ConstIterator</a> it2;
<a name="l00631"></a>00631   <span class="keywordflow">for</span>( it2 = p.<a class="codeRef" href="qvaluelist.html#begin">begin</a>(); it2 != p.<a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it2 ) {
<a name="l00632"></a>00632     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;    Type: &quot;</span> &lt;&lt; int((*it2).type()) &lt;&lt; <span class="stringliteral">&quot; Number: &quot;</span> &lt;&lt; (*it2).number() &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00633"></a>00633   }
<a name="l00634"></a>00634   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  }&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00635"></a>00635 
<a name="l00636"></a>00636   <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">Address::List</a> a = <a class="code" href="classKABC_1_1Addressee.html#a2eb7d78ead23236a1bd80d9f0f432371" title="Return list of all addresses.">addresses</a>();
<a name="l00637"></a>00637   <a class="codeRef" href="qvaluelist.html#ConstIterator">Address::List::ConstIterator</a> it3;
<a name="l00638"></a>00638   <span class="keywordflow">for</span>( it3 = a.<a class="codeRef" href="qvaluelist.html#begin">begin</a>(); it3 != a.<a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it3 ) {
<a name="l00639"></a>00639     (*it3).dump();
<a name="l00640"></a>00640   }
<a name="l00641"></a>00641 
<a name="l00642"></a>00642   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  Keys {&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00643"></a>00643   <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">Key::List</a> k = <a class="code" href="classKABC_1_1Addressee.html#a490f3ae84cc7a34e9d55379a9bb8f3bb" title="Return list of all keys.">keys</a>();
<a name="l00644"></a>00644   <a class="codeRef" href="qvaluelist.html#ConstIterator">Key::List::ConstIterator</a> it4;
<a name="l00645"></a>00645   <span class="keywordflow">for</span>( it4 = k.<a class="codeRef" href="qvaluelist.html#begin">begin</a>(); it4 != k.<a class="codeRef" href="qvaluelist.html#end">end</a>(); ++it4 ) {
<a name="l00646"></a>00646     <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;    Type: &quot;</span> &lt;&lt; int((*it4).type()) &lt;&lt;
<a name="l00647"></a>00647                      <span class="stringliteral">&quot; Key: &quot;</span> &lt;&lt; (*it4).textData() &lt;&lt;
<a name="l00648"></a>00648                      <span class="stringliteral">&quot; CustomString: &quot;</span> &lt;&lt; (*it4).customTypeString() &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00649"></a>00649   }
<a name="l00650"></a>00650   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;  }&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00651"></a>00651 
<a name="l00652"></a>00652   <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(5700) &lt;&lt; <span class="stringliteral">&quot;}&quot;</span> &lt;&lt; <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00653"></a>00653 }
<a name="l00654"></a>00654 
<a name="l00655"></a>00655 
<a name="l00656"></a><a class="code" href="classKABC_1_1Addressee.html#ab9cabc3c3dc00eecf29c640a4ef7588d">00656</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#ab9cabc3c3dc00eecf29c640a4ef7588d" title="Insert an address.">Addressee::insertAddress</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a> &amp;address )
<a name="l00657"></a>00657 {
<a name="l00658"></a>00658   <span class="keywordflow">if</span> ( address.<a class="code" href="classKABC_1_1Address.html#a7c8be4b1d1a33ed2fae7d774db7b9f64" title="Returns true, if the address is empty.">isEmpty</a>() )
<a name="l00659"></a>00659     <span class="keywordflow">return</span>;
<a name="l00660"></a>00660 
<a name="l00661"></a>00661   detach();
<a name="l00662"></a>00662   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00663"></a>00663 
<a name="l00664"></a>00664   <a class="codeRef" href="qvaluelist.html#Iterator">Address::List::Iterator</a> it;
<a name="l00665"></a>00665   <span class="keywordflow">for</span>( it = mData-&gt;addresses.begin(); it != mData-&gt;addresses.end(); ++it ) {
<a name="l00666"></a>00666     <span class="keywordflow">if</span> ( (*it).id() == address.id() ) {
<a name="l00667"></a>00667       *it = <a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964" title="Return address, which matches the given type.">address</a>;
<a name="l00668"></a>00668       <span class="keywordflow">return</span>;
<a name="l00669"></a>00669     }
<a name="l00670"></a>00670   }
<a name="l00671"></a>00671 
<a name="l00672"></a>00672   mData-&gt;addresses.append( address );
<a name="l00673"></a>00673 }
<a name="l00674"></a>00674 
<a name="l00675"></a><a class="code" href="classKABC_1_1Addressee.html#a4652028f517120091556c9b6621beddb">00675</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a4652028f517120091556c9b6621beddb" title="Remove address.">Addressee::removeAddress</a>( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a> &amp;address )
<a name="l00676"></a>00676 {
<a name="l00677"></a>00677   detach();
<a name="l00678"></a>00678 
<a name="l00679"></a>00679   <a class="codeRef" href="qvaluelist.html#Iterator">Address::List::Iterator</a> it;
<a name="l00680"></a>00680   <span class="keywordflow">for</span>( it = mData-&gt;addresses.begin(); it != mData-&gt;addresses.end(); ++it ) {
<a name="l00681"></a>00681     <span class="keywordflow">if</span> ( (*it).id() == address.id() ) {
<a name="l00682"></a>00682       mData-&gt;addresses.remove( it );
<a name="l00683"></a>00683       <span class="keywordflow">return</span>;
<a name="l00684"></a>00684     }
<a name="l00685"></a>00685   }
<a name="l00686"></a>00686 }
<a name="l00687"></a>00687 
<a name="l00688"></a><a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964">00688</a> <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a> <a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964" title="Return address, which matches the given type.">Addressee::address</a>( <span class="keywordtype">int</span> type )<span class="keyword"> const</span>
<a name="l00689"></a>00689 <span class="keyword"></span>{
<a name="l00690"></a>00690   <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a> <a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964" title="Return address, which matches the given type.">address</a>( type );
<a name="l00691"></a>00691   <a class="codeRef" href="qvaluelist.html#ConstIterator">Address::List::ConstIterator</a> it;
<a name="l00692"></a>00692   <span class="keywordflow">for</span>( it = mData-&gt;addresses.constBegin(); it != mData-&gt;addresses.constEnd(); ++it ) {
<a name="l00693"></a>00693     <span class="keywordflow">if</span> ( matchBinaryPattern( (*it).type(), type ) ) {
<a name="l00694"></a>00694       <span class="keywordflow">if</span> ( (*it).type() &amp; Address::Pref )
<a name="l00695"></a>00695         <span class="keywordflow">return</span> (*it);
<a name="l00696"></a>00696       <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( address.<a class="code" href="classKABC_1_1Address.html#a7c8be4b1d1a33ed2fae7d774db7b9f64" title="Returns true, if the address is empty.">isEmpty</a>() )
<a name="l00697"></a>00697         address = (*it);
<a name="l00698"></a>00698     }
<a name="l00699"></a>00699   }
<a name="l00700"></a>00700 
<a name="l00701"></a>00701   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964" title="Return address, which matches the given type.">address</a>;
<a name="l00702"></a>00702 }
<a name="l00703"></a>00703 
<a name="l00704"></a><a class="code" href="classKABC_1_1Addressee.html#a2eb7d78ead23236a1bd80d9f0f432371">00704</a> <a class="codeRef" href="qvaluelist.html">Address::List</a> <a class="code" href="classKABC_1_1Addressee.html#a2eb7d78ead23236a1bd80d9f0f432371" title="Return list of all addresses.">Addressee::addresses</a>()<span class="keyword"> const</span>
<a name="l00705"></a>00705 <span class="keyword"></span>{
<a name="l00706"></a>00706   <span class="keywordflow">return</span> mData-&gt;addresses;
<a name="l00707"></a>00707 }
<a name="l00708"></a>00708 
<a name="l00709"></a><a class="code" href="classKABC_1_1Addressee.html#aedeb06f6e7bf3dd3fb3e3d5ed4592e98">00709</a> <a class="codeRef" href="qvaluelist.html">Address::List</a> <a class="code" href="classKABC_1_1Addressee.html#a2eb7d78ead23236a1bd80d9f0f432371" title="Return list of all addresses.">Addressee::addresses</a>( <span class="keywordtype">int</span> type )<span class="keyword"> const</span>
<a name="l00710"></a>00710 <span class="keyword"></span>{
<a name="l00711"></a>00711   <a class="codeRef" href="qvaluelist.html">Address::List</a> list;
<a name="l00712"></a>00712 
<a name="l00713"></a>00713   <a class="codeRef" href="qvaluelist.html#ConstIterator">Address::List::ConstIterator</a> it;
<a name="l00714"></a>00714   <span class="keywordflow">for</span>( it = mData-&gt;addresses.constBegin(); it != mData-&gt;addresses.constEnd(); ++it ) {
<a name="l00715"></a>00715     <span class="keywordflow">if</span> ( matchBinaryPattern( (*it).type(), type ) ) {
<a name="l00716"></a>00716       list.<a class="codeRef" href="qvaluelist.html#append">append</a>( *it );
<a name="l00717"></a>00717     }
<a name="l00718"></a>00718   }
<a name="l00719"></a>00719 
<a name="l00720"></a>00720   <span class="keywordflow">return</span> list;
<a name="l00721"></a>00721 }
<a name="l00722"></a>00722 
<a name="l00723"></a><a class="code" href="classKABC_1_1Addressee.html#aa265c56b4d8e67344d1b48232d2d6eff">00723</a> <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a> <a class="code" href="classKABC_1_1Addressee.html#aa265c56b4d8e67344d1b48232d2d6eff" title="Return address with the given id.">Addressee::findAddress</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;<span class="keywordtype">id</span> )<span class="keyword"> const</span>
<a name="l00724"></a>00724 <span class="keyword"></span>{
<a name="l00725"></a>00725   <a class="codeRef" href="qvaluelist.html#ConstIterator">Address::List::ConstIterator</a> it;
<a name="l00726"></a>00726   <span class="keywordflow">for</span>( it = mData-&gt;addresses.constBegin(); it != mData-&gt;addresses.constEnd(); ++it ) {
<a name="l00727"></a>00727     <span class="keywordflow">if</span> ( (*it).id() == id ) {
<a name="l00728"></a>00728       <span class="keywordflow">return</span> *it;
<a name="l00729"></a>00729     }
<a name="l00730"></a>00730   }
<a name="l00731"></a>00731   <span class="keywordflow">return</span> <a class="code" href="classKABC_1_1Address.html" title="Postal address information.">Address</a>();
<a name="l00732"></a>00732 }
<a name="l00733"></a>00733 
<a name="l00734"></a><a class="code" href="classKABC_1_1Addressee.html#af56d927077cb2f50df6795bb62f6120e">00734</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#af56d927077cb2f50df6795bb62f6120e" title="Insert category.">Addressee::insertCategory</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;c )
<a name="l00735"></a>00735 {
<a name="l00736"></a>00736   detach();
<a name="l00737"></a>00737   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00738"></a>00738 
<a name="l00739"></a>00739   <span class="keywordflow">if</span> ( mData-&gt;categories.findIndex( c ) != -1 ) <span class="keywordflow">return</span>;
<a name="l00740"></a>00740 
<a name="l00741"></a>00741   mData-&gt;categories.append( c );
<a name="l00742"></a>00742 }
<a name="l00743"></a>00743 
<a name="l00744"></a><a class="code" href="classKABC_1_1Addressee.html#a8d35e843d87c132a3646d73d3d03636d">00744</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a8d35e843d87c132a3646d73d3d03636d" title="Remove category.">Addressee::removeCategory</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;c )
<a name="l00745"></a>00745 {
<a name="l00746"></a>00746   detach();
<a name="l00747"></a>00747 
<a name="l00748"></a>00748   QStringList::Iterator it = mData-&gt;categories.find( c );
<a name="l00749"></a>00749   <span class="keywordflow">if</span> ( it == mData-&gt;categories.end() ) <span class="keywordflow">return</span>;
<a name="l00750"></a>00750 
<a name="l00751"></a>00751   mData-&gt;categories.remove( it );
<a name="l00752"></a>00752 }
<a name="l00753"></a>00753 
<a name="l00754"></a><a class="code" href="classKABC_1_1Addressee.html#a878823edd6a5821c543f4db582a9aa63">00754</a> <span class="keywordtype">bool</span> <a class="code" href="classKABC_1_1Addressee.html#a878823edd6a5821c543f4db582a9aa63" title="Return, if addressee has the given category.">Addressee::hasCategory</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;c )<span class="keyword"> const</span>
<a name="l00755"></a>00755 <span class="keyword"></span>{
<a name="l00756"></a>00756   <span class="keywordflow">return</span> ( mData-&gt;categories.findIndex( c ) != -1 );
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 
<a name="l00759"></a><a class="code" href="classKABC_1_1Addressee.html#a923d0a372a29775f4e22e9f0d3d3d1f7">00759</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a923d0a372a29775f4e22e9f0d3d3d1f7" title="Set categories to given value.">Addressee::setCategories</a>( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &amp;c )
<a name="l00760"></a>00760 {
<a name="l00761"></a>00761   detach();
<a name="l00762"></a>00762   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00763"></a>00763 
<a name="l00764"></a>00764   mData-&gt;categories = c;
<a name="l00765"></a>00765 }
<a name="l00766"></a>00766 
<a name="l00767"></a><a class="code" href="classKABC_1_1Addressee.html#ac149550eaa9298bea4602b771315863f">00767</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#ac149550eaa9298bea4602b771315863f" title="Return list of all set categories.">Addressee::categories</a>()<span class="keyword"> const</span>
<a name="l00768"></a>00768 <span class="keyword"></span>{
<a name="l00769"></a>00769   <span class="keywordflow">return</span> mData-&gt;categories;
<a name="l00770"></a>00770 }
<a name="l00771"></a>00771 
<a name="l00772"></a><a class="code" href="classKABC_1_1Addressee.html#a30c1ada1e9905a05368d8e954be75637">00772</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a30c1ada1e9905a05368d8e954be75637" title="Insert custom entry.">Addressee::insertCustom</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;app, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;name,
<a name="l00773"></a>00773                               <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;value )
<a name="l00774"></a>00774 {
<a name="l00775"></a>00775   <span class="keywordflow">if</span> ( value.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || name.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() || app.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() ) <span class="keywordflow">return</span>;
<a name="l00776"></a>00776 
<a name="l00777"></a>00777   detach();
<a name="l00778"></a>00778   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00779"></a>00779 
<a name="l00780"></a>00780   <a class="codeRef" href="qstring.html">QString</a> qualifiedName = app + <span class="stringliteral">&quot;-&quot;</span> + name + <span class="stringliteral">&quot;:&quot;</span>;
<a name="l00781"></a>00781 
<a name="l00782"></a>00782   QStringList::Iterator it;
<a name="l00783"></a>00783   <span class="keywordflow">for</span>( it = mData-&gt;custom.begin(); it != mData-&gt;custom.end(); ++it ) {
<a name="l00784"></a>00784     <span class="keywordflow">if</span> ( (*it).startsWith( qualifiedName ) ) {
<a name="l00785"></a>00785       (*it) = qualifiedName + value;
<a name="l00786"></a>00786       <span class="keywordflow">return</span>;
<a name="l00787"></a>00787     }
<a name="l00788"></a>00788   }
<a name="l00789"></a>00789 
<a name="l00790"></a>00790   mData-&gt;custom.append( qualifiedName + value );
<a name="l00791"></a>00791 }
<a name="l00792"></a>00792 
<a name="l00793"></a><a class="code" href="classKABC_1_1Addressee.html#a91ed8be38b4ddebd5af71577011fab26">00793</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a91ed8be38b4ddebd5af71577011fab26" title="Remove custom entry.">Addressee::removeCustom</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;app, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;name)
<a name="l00794"></a>00794 {
<a name="l00795"></a>00795   detach();
<a name="l00796"></a>00796 
<a name="l00797"></a>00797   <a class="codeRef" href="qstring.html">QString</a> qualifiedName = app + <span class="stringliteral">&quot;-&quot;</span> + name + <span class="stringliteral">&quot;:&quot;</span>;
<a name="l00798"></a>00798 
<a name="l00799"></a>00799   QStringList::Iterator it;
<a name="l00800"></a>00800   <span class="keywordflow">for</span>( it = mData-&gt;custom.begin(); it != mData-&gt;custom.end(); ++it ) {
<a name="l00801"></a>00801     <span class="keywordflow">if</span> ( (*it).startsWith( qualifiedName ) ) {
<a name="l00802"></a>00802       mData-&gt;custom.remove( it );
<a name="l00803"></a>00803       <span class="keywordflow">return</span>;
<a name="l00804"></a>00804     }
<a name="l00805"></a>00805   }
<a name="l00806"></a>00806 }
<a name="l00807"></a>00807 
<a name="l00808"></a><a class="code" href="classKABC_1_1Addressee.html#a7aa0e3bc38e2c05adf0c11e9464defc4">00808</a> <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKABC_1_1Addressee.html#a7aa0e3bc38e2c05adf0c11e9464defc4" title="Return value of custom entry, identified by app and entry name.">Addressee::custom</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;app, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;name )<span class="keyword"> const</span>
<a name="l00809"></a>00809 <span class="keyword"></span>{
<a name="l00810"></a>00810   <a class="codeRef" href="qstring.html">QString</a> qualifiedName = app + <span class="stringliteral">&quot;-&quot;</span> + name + <span class="stringliteral">&quot;:&quot;</span>;
<a name="l00811"></a>00811   <a class="codeRef" href="qstring.html">QString</a> value;
<a name="l00812"></a>00812 
<a name="l00813"></a>00813   QStringList::ConstIterator it;
<a name="l00814"></a>00814   <span class="keywordflow">for</span>( it = mData-&gt;custom.constBegin(); it != mData-&gt;custom.constEnd(); ++it ) {
<a name="l00815"></a>00815     <span class="keywordflow">if</span> ( (*it).startsWith( qualifiedName ) ) {
<a name="l00816"></a>00816       value = (*it).<a class="codeRef" href="qstring.html#mid">mid</a>( (*it).find( <span class="stringliteral">&quot;:&quot;</span> ) + 1 );
<a name="l00817"></a>00817       <span class="keywordflow">break</span>;
<a name="l00818"></a>00818     }
<a name="l00819"></a>00819   }
<a name="l00820"></a>00820 
<a name="l00821"></a>00821   <span class="keywordflow">return</span> value;
<a name="l00822"></a>00822 }
<a name="l00823"></a>00823 
<a name="l00824"></a><a class="code" href="classKABC_1_1Addressee.html#a210917d8d74cdb6daefc6365534f0b41">00824</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a210917d8d74cdb6daefc6365534f0b41" title="Set all custom entries.">Addressee::setCustoms</a>( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &amp;l )
<a name="l00825"></a>00825 {
<a name="l00826"></a>00826   detach();
<a name="l00827"></a>00827   mData-&gt;empty = <span class="keyword">false</span>;
<a name="l00828"></a>00828 
<a name="l00829"></a>00829   mData-&gt;custom = l;
<a name="l00830"></a>00830 }
<a name="l00831"></a>00831 
<a name="l00832"></a><a class="code" href="classKABC_1_1Addressee.html#a345dec05bd2a41add4bbb9fd78fcfd98">00832</a> <a class="codeRef" href="qstringlist.html">QStringList</a> <a class="code" href="classKABC_1_1Addressee.html#a345dec05bd2a41add4bbb9fd78fcfd98" title="Return list of all custom entries.">Addressee::customs</a>()<span class="keyword"> const</span>
<a name="l00833"></a>00833 <span class="keyword"></span>{
<a name="l00834"></a>00834   <span class="keywordflow">return</span> mData-&gt;custom;
<a name="l00835"></a>00835 }
<a name="l00836"></a>00836 
<a name="l00837"></a><a class="code" href="classKABC_1_1Addressee.html#a7587feac4e71988832a6f28a3a6d25fc">00837</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a7587feac4e71988832a6f28a3a6d25fc" title="Parse full email address.">Addressee::parseEmailAddress</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &amp;rawEmail, <a class="codeRef" href="qstring.html">QString</a> &amp;fullName,
<a name="l00838"></a>00838                                    <a class="codeRef" href="qstring.html">QString</a> &amp;email)
<a name="l00839"></a>00839 {
<a name="l00840"></a>00840   <span class="comment">// This is a simplified version of KPIM::splitAddress().</span>
<a name="l00841"></a>00841 
<a name="l00842"></a>00842   fullName = <span class="stringliteral">&quot;&quot;</span>;
<a name="l00843"></a>00843   email = <span class="stringliteral">&quot;&quot;</span>;
<a name="l00844"></a>00844   <span class="keywordflow">if</span> ( rawEmail.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00845"></a>00845     <span class="keywordflow">return</span>; <span class="comment">// KPIM::AddressEmpty;</span>
<a name="l00846"></a>00846 
<a name="l00847"></a>00847   <span class="comment">// The code works on 8-bit strings, so convert the input to UTF-8.</span>
<a name="l00848"></a>00848   <a class="codeRef" href="qcstring.html">QCString</a> <a class="code" href="classKABC_1_1Addressee.html#ad88426b3309d907f9b1c947244285964" title="Return address, which matches the given type.">address</a> = rawEmail.<a class="codeRef" href="qstring.html#utf8">utf8</a>();
<a name="l00849"></a>00849 
<a name="l00850"></a>00850   <a class="codeRef" href="qcstring.html">QCString</a> displayName;
<a name="l00851"></a>00851   <a class="codeRef" href="qcstring.html">QCString</a> addrSpec;
<a name="l00852"></a>00852   <a class="codeRef" href="qcstring.html">QCString</a> comment;
<a name="l00853"></a>00853 
<a name="l00854"></a>00854   <span class="comment">// The following is a primitive parser for a mailbox-list (cf. RFC 2822).</span>
<a name="l00855"></a>00855   <span class="comment">// The purpose is to extract a displayable string from the mailboxes.</span>
<a name="l00856"></a>00856   <span class="comment">// Comments in the addr-spec are not handled. No error checking is done.</span>
<a name="l00857"></a>00857 
<a name="l00858"></a>00858   <span class="keyword">enum</span> { TopLevel, InComment, InAngleAddress } context = TopLevel;
<a name="l00859"></a>00859   <span class="keywordtype">bool</span> inQuotedString = <span class="keyword">false</span>;
<a name="l00860"></a>00860   <span class="keywordtype">int</span> commentLevel = 0;
<a name="l00861"></a>00861   <span class="keywordtype">bool</span> stop = <span class="keyword">false</span>;
<a name="l00862"></a>00862 
<a name="l00863"></a>00863   <span class="keywordflow">for</span> ( <span class="keywordtype">char</span>* p = address.data(); *p &amp;&amp; !stop; ++p ) {
<a name="l00864"></a>00864     <span class="keywordflow">switch</span> ( context ) {
<a name="l00865"></a>00865     <span class="keywordflow">case</span> TopLevel : {
<a name="l00866"></a>00866       <span class="keywordflow">switch</span> ( *p ) {
<a name="l00867"></a>00867       <span class="keywordflow">case</span> <span class="charliteral">&#39;&quot;&#39;</span> : inQuotedString = !inQuotedString;
<a name="l00868"></a>00868                  displayName += *p;
<a name="l00869"></a>00869                  <span class="keywordflow">break</span>;
<a name="l00870"></a>00870       <span class="keywordflow">case</span> <span class="charliteral">&#39;(&#39;</span> : <span class="keywordflow">if</span> ( !inQuotedString ) {
<a name="l00871"></a>00871                    context = InComment;
<a name="l00872"></a>00872                    commentLevel = 1;
<a name="l00873"></a>00873                  }
<a name="l00874"></a>00874                  <span class="keywordflow">else</span>
<a name="l00875"></a>00875                    displayName += *p;
<a name="l00876"></a>00876                  <span class="keywordflow">break</span>;
<a name="l00877"></a>00877       <span class="keywordflow">case</span> <span class="charliteral">&#39;&lt;&#39;</span> : <span class="keywordflow">if</span> ( !inQuotedString ) {
<a name="l00878"></a>00878                    context = InAngleAddress;
<a name="l00879"></a>00879                  }
<a name="l00880"></a>00880                  <span class="keywordflow">else</span>
<a name="l00881"></a>00881                    displayName += *p;
<a name="l00882"></a>00882                  <span class="keywordflow">break</span>;
<a name="l00883"></a>00883       <span class="keywordflow">case</span> <span class="charliteral">&#39;\\&#39;</span> : <span class="comment">// quoted character</span>
<a name="l00884"></a>00884                  displayName += *p;
<a name="l00885"></a>00885                  ++p; <span class="comment">// skip the &#39;\&#39;</span>
<a name="l00886"></a>00886                  <span class="keywordflow">if</span> ( *p )
<a name="l00887"></a>00887                    displayName += *p;
<a name="l00888"></a>00888                  <span class="keywordflow">else</span>
<a name="l00889"></a>00889                    <span class="comment">//return KPIM::UnexpectedEnd;</span>
<a name="l00890"></a>00890                    <span class="keywordflow">goto</span> ABORT_PARSING;
<a name="l00891"></a>00891                  <span class="keywordflow">break</span>;
<a name="l00892"></a>00892       <span class="keywordflow">case</span> <span class="charliteral">&#39;,&#39;</span> : <span class="keywordflow">if</span> ( !inQuotedString ) {
<a name="l00893"></a>00893                    <span class="comment">//if ( allowMultipleAddresses )</span>
<a name="l00894"></a>00894                    <span class="comment">//  stop = true;</span>
<a name="l00895"></a>00895                    <span class="comment">//else</span>
<a name="l00896"></a>00896                    <span class="comment">//  return KPIM::UnexpectedComma;</span>
<a name="l00897"></a>00897                    <span class="keywordflow">goto</span> ABORT_PARSING;
<a name="l00898"></a>00898                  }
<a name="l00899"></a>00899                  <span class="keywordflow">else</span>
<a name="l00900"></a>00900                    displayName += *p;
<a name="l00901"></a>00901                  <span class="keywordflow">break</span>;
<a name="l00902"></a>00902       <span class="keywordflow">default</span> :  displayName += *p;
<a name="l00903"></a>00903       }
<a name="l00904"></a>00904       <span class="keywordflow">break</span>;
<a name="l00905"></a>00905     }
<a name="l00906"></a>00906     <span class="keywordflow">case</span> InComment : {
<a name="l00907"></a>00907       <span class="keywordflow">switch</span> ( *p ) {
<a name="l00908"></a>00908       <span class="keywordflow">case</span> <span class="charliteral">&#39;(&#39;</span> : ++commentLevel;
<a name="l00909"></a>00909                  comment += *p;
<a name="l00910"></a>00910                  <span class="keywordflow">break</span>;
<a name="l00911"></a>00911       <span class="keywordflow">case</span> <span class="charliteral">&#39;)&#39;</span> : --commentLevel;
<a name="l00912"></a>00912                  <span class="keywordflow">if</span> ( commentLevel == 0 ) {
<a name="l00913"></a>00913                    context = TopLevel;
<a name="l00914"></a>00914                    comment += <span class="charliteral">&#39; &#39;</span>; <span class="comment">// separate the text of several comments</span>
<a name="l00915"></a>00915                  }
<a name="l00916"></a>00916                  <span class="keywordflow">else</span>
<a name="l00917"></a>00917                    comment += *p;
<a name="l00918"></a>00918                  <span class="keywordflow">break</span>;
<a name="l00919"></a>00919       <span class="keywordflow">case</span> <span class="charliteral">&#39;\\&#39;</span> : <span class="comment">// quoted character</span>
<a name="l00920"></a>00920                  comment += *p;
<a name="l00921"></a>00921                  ++p; <span class="comment">// skip the &#39;\&#39;</span>
<a name="l00922"></a>00922                  <span class="keywordflow">if</span> ( *p )
<a name="l00923"></a>00923                    comment += *p;
<a name="l00924"></a>00924                  <span class="keywordflow">else</span>
<a name="l00925"></a>00925                    <span class="comment">//return KPIM::UnexpectedEnd;</span>
<a name="l00926"></a>00926                    <span class="keywordflow">goto</span> ABORT_PARSING;
<a name="l00927"></a>00927                  <span class="keywordflow">break</span>;
<a name="l00928"></a>00928       <span class="keywordflow">default</span> :  comment += *p;
<a name="l00929"></a>00929       }
<a name="l00930"></a>00930       <span class="keywordflow">break</span>;
<a name="l00931"></a>00931     }
<a name="l00932"></a>00932     <span class="keywordflow">case</span> InAngleAddress : {
<a name="l00933"></a>00933       <span class="keywordflow">switch</span> ( *p ) {
<a name="l00934"></a>00934       <span class="keywordflow">case</span> <span class="charliteral">&#39;&quot;&#39;</span> : inQuotedString = !inQuotedString;
<a name="l00935"></a>00935                  addrSpec += *p;
<a name="l00936"></a>00936                  <span class="keywordflow">break</span>;
<a name="l00937"></a>00937       <span class="keywordflow">case</span> <span class="charliteral">&#39;&gt;&#39;</span> : <span class="keywordflow">if</span> ( !inQuotedString ) {
<a name="l00938"></a>00938                    context = TopLevel;
<a name="l00939"></a>00939                  }
<a name="l00940"></a>00940                  <span class="keywordflow">else</span>
<a name="l00941"></a>00941                    addrSpec += *p;
<a name="l00942"></a>00942                  <span class="keywordflow">break</span>;
<a name="l00943"></a>00943       <span class="keywordflow">case</span> <span class="charliteral">&#39;\\&#39;</span> : <span class="comment">// quoted character</span>
<a name="l00944"></a>00944                  addrSpec += *p;
<a name="l00945"></a>00945                  ++p; <span class="comment">// skip the &#39;\&#39;</span>
<a name="l00946"></a>00946                  <span class="keywordflow">if</span> ( *p )
<a name="l00947"></a>00947                    addrSpec += *p;
<a name="l00948"></a>00948                  <span class="keywordflow">else</span>
<a name="l00949"></a>00949                    <span class="comment">//return KPIM::UnexpectedEnd;</span>
<a name="l00950"></a>00950                    <span class="keywordflow">goto</span> ABORT_PARSING;
<a name="l00951"></a>00951                  <span class="keywordflow">break</span>;
<a name="l00952"></a>00952       <span class="keywordflow">default</span> :  addrSpec += *p;
<a name="l00953"></a>00953       }
<a name="l00954"></a>00954       <span class="keywordflow">break</span>;
<a name="l00955"></a>00955     }
<a name="l00956"></a>00956     } <span class="comment">// switch ( context )</span>
<a name="l00957"></a>00957   }
<a name="l00958"></a>00958 
<a name="l00959"></a>00959 ABORT_PARSING:
<a name="l00960"></a>00960   displayName = displayName.<a class="codeRef" href="qcstring.html#stripWhiteSpace">stripWhiteSpace</a>();
<a name="l00961"></a>00961   comment = comment.<a class="codeRef" href="qcstring.html#stripWhiteSpace">stripWhiteSpace</a>();
<a name="l00962"></a>00962   addrSpec = addrSpec.<a class="codeRef" href="qcstring.html#stripWhiteSpace">stripWhiteSpace</a>();
<a name="l00963"></a>00963 
<a name="l00964"></a>00964   fullName = <a class="codeRef" href="qstring.html#fromUtf8">QString::fromUtf8</a>( displayName );
<a name="l00965"></a>00965   email = <a class="codeRef" href="qstring.html#fromUtf8">QString::fromUtf8</a>( addrSpec );
<a name="l00966"></a>00966 
<a name="l00967"></a>00967   <span class="comment">// check for errors</span>
<a name="l00968"></a>00968   <span class="keywordflow">if</span> ( inQuotedString )
<a name="l00969"></a>00969     <span class="keywordflow">return</span>; <span class="comment">// KPIM::UnbalancedQuote;</span>
<a name="l00970"></a>00970   <span class="keywordflow">if</span> ( context == InComment )
<a name="l00971"></a>00971     <span class="keywordflow">return</span>; <span class="comment">// KPIM::UnbalancedParens;</span>
<a name="l00972"></a>00972   <span class="keywordflow">if</span> ( context == InAngleAddress )
<a name="l00973"></a>00973     <span class="keywordflow">return</span>; <span class="comment">// KPIM::UnclosedAngleAddr;</span>
<a name="l00974"></a>00974 
<a name="l00975"></a>00975   <span class="keywordflow">if</span> ( addrSpec.<a class="codeRef" href="qcstring.html#isEmpty">isEmpty</a>() ) {
<a name="l00976"></a>00976     <span class="keywordflow">if</span> ( displayName.<a class="codeRef" href="qcstring.html#isEmpty">isEmpty</a>() )
<a name="l00977"></a>00977       <span class="keywordflow">return</span>; <span class="comment">// KPIM::NoAddressSpec;</span>
<a name="l00978"></a>00978     <span class="keywordflow">else</span> {
<a name="l00979"></a>00979       <span class="comment">//addrSpec = displayName;</span>
<a name="l00980"></a>00980       <span class="comment">//displayName.truncate( 0 );</span>
<a name="l00981"></a>00981       <span class="comment">// Address of the form &quot;foo@bar&quot; or &quot;foo@bar (Name)&quot;.</span>
<a name="l00982"></a>00982       email = fullName;
<a name="l00983"></a>00983       fullName = <a class="codeRef" href="qstring.html#fromUtf8">QString::fromUtf8</a>( comment );
<a name="l00984"></a>00984     }
<a name="l00985"></a>00985   }
<a name="l00986"></a>00986 
<a name="l00987"></a>00987   <span class="comment">// Check that we do not have any extra characters on the end of the</span>
<a name="l00988"></a>00988   <span class="comment">// strings</span>
<a name="l00989"></a>00989   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> len = fullName.<a class="codeRef" href="qstring.html#length">length</a>();
<a name="l00990"></a>00990   <span class="keywordflow">if</span> ( fullName[ 0 ] == <span class="charliteral">&#39;&quot;&#39;</span> &amp;&amp; fullName[ len - 1 ] == <span class="charliteral">&#39;&quot;&#39;</span> )
<a name="l00991"></a>00991     fullName = fullName.<a class="codeRef" href="qstring.html#mid">mid</a>( 1, len - 2 );
<a name="l00992"></a>00992 }
<a name="l00993"></a>00993 
<a name="l00994"></a><a class="code" href="classKABC_1_1Addressee.html#ac67dcf61975851b977f6101c46c043d8">00994</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#ac67dcf61975851b977f6101c46c043d8" title="Set resource where the addressee is from.">Addressee::setResource</a>( Resource *resource )
<a name="l00995"></a>00995 {
<a name="l00996"></a>00996   detach();
<a name="l00997"></a>00997   mData-&gt;resource = <a class="code" href="classKABC_1_1Addressee.html#af097d2c55ca1e8f3574e96eb675924a7" title="Return pointer to resource.">resource</a>;
<a name="l00998"></a>00998 }
<a name="l00999"></a>00999 
<a name="l01000"></a><a class="code" href="classKABC_1_1Addressee.html#af097d2c55ca1e8f3574e96eb675924a7">01000</a> Resource *<a class="code" href="classKABC_1_1Addressee.html#af097d2c55ca1e8f3574e96eb675924a7" title="Return pointer to resource.">Addressee::resource</a>()<span class="keyword"> const</span>
<a name="l01001"></a>01001 <span class="keyword"></span>{
<a name="l01002"></a>01002   <span class="keywordflow">return</span> mData-&gt;resource;
<a name="l01003"></a>01003 }
<a name="l01004"></a>01004 
<a name="l01005"></a><a class="code" href="classKABC_1_1Addressee.html#a8db9c60e2c1af4f752dc9481dba93c69">01005</a> <span class="keywordtype">void</span> <a class="code" href="classKABC_1_1Addressee.html#a8db9c60e2c1af4f752dc9481dba93c69" title="Mark addressee as changed.">Addressee::setChanged</a>( <span class="keywordtype">bool</span> value )
<a name="l01006"></a>01006 {
<a name="l01007"></a>01007   detach();
<a name="l01008"></a>01008   mData-&gt;changed = value;
<a name="l01009"></a>01009 }
<a name="l01010"></a>01010 
<a name="l01011"></a><a class="code" href="classKABC_1_1Addressee.html#a7b3932cedddfb6e2db1d5e869277525b">01011</a> <span class="keywordtype">bool</span> <a class="code" href="classKABC_1_1Addressee.html#a7b3932cedddfb6e2db1d5e869277525b" title="Return whether the addressee is changed.">Addressee::changed</a>()<span class="keyword"> const</span>
<a name="l01012"></a>01012 <span class="keyword"></span>{
<a name="l01013"></a>01013   <span class="keywordflow">return</span> mData-&gt;changed;
<a name="l01014"></a>01014 }
<a name="l01015"></a>01015 
<a name="l01016"></a>01016 <span class="keywordtype">void</span> Addressee::setSortMode( <a class="code" href="classKABC_1_1SortMode.html" title="Sort method for sorting an addressee list.">KABC::SortMode</a> *mode )
<a name="l01017"></a>01017 {
<a name="l01018"></a>01018   mSortMode = mode;
<a name="l01019"></a>01019 }
<a name="l01020"></a>01020 
<a name="l01021"></a>01021 <span class="keywordtype">bool</span> Addressee::operator&lt; ( <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;addr )
<a name="l01022"></a>01022 {
<a name="l01023"></a>01023   <span class="keywordflow">if</span> ( !mSortMode )
<a name="l01024"></a>01024     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01025"></a>01025   <span class="keywordflow">else</span>
<a name="l01026"></a>01026     <span class="keywordflow">return</span> mSortMode-&gt;<a class="code" href="classKABC_1_1SortMode.html#aea3c51c0cfded76b975443b9433f5a84" title="Reimplement this method and return whether the first contact is &#39;smaller&#39; than the second...">lesser</a>( *<span class="keyword">this</span>, addr );
<a name="l01027"></a>01027 }
<a name="l01028"></a>01028 
<a name="l01029"></a>01029 <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp;KABC::operator&lt;&lt;( <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp;s, <span class="keyword">const</span> <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )
<a name="l01030"></a>01030 {
<a name="l01031"></a>01031   <span class="keywordflow">if</span> (!a.mData) <span class="keywordflow">return</span> s;
<a name="l01032"></a>01032 
<a name="l01033"></a>01033   s &lt;&lt; a.<a class="code" href="classKABC_1_1Addressee.html#ac16cb9785e3573cd18fad3f975f18b12" title="Return unique identifier.">uid</a>();
<a name="l01034"></a>01034 
<a name="l01035"></a>01035   --STREAMOUT--
<a name="l01036"></a>01036   s &lt;&lt; a.mData-&gt;phoneNumbers;
<a name="l01037"></a>01037   s &lt;&lt; a.mData-&gt;addresses;
<a name="l01038"></a>01038   s &lt;&lt; a.mData-&gt;emails;
<a name="l01039"></a>01039   s &lt;&lt; a.mData-&gt;categories;
<a name="l01040"></a>01040   s &lt;&lt; a.mData-&gt;custom;
<a name="l01041"></a>01041   s &lt;&lt; a.mData-&gt;keys;
<a name="l01042"></a>01042   <span class="keywordflow">return</span> s;
<a name="l01043"></a>01043 }
<a name="l01044"></a>01044 
<a name="l01045"></a>01045 <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp;KABC::operator&gt;&gt;( <a class="codeRef" href="qdatastream.html">QDataStream</a> &amp;s, <a class="code" href="classKABC_1_1Addressee.html" title="address book entry">Addressee</a> &amp;a )
<a name="l01046"></a>01046 {
<a name="l01047"></a>01047   <span class="keywordflow">if</span> (!a.mData)
<a name="l01048"></a>01048     <span class="keywordflow">return</span> s;
<a name="l01049"></a>01049 
<a name="l01050"></a>01050   a.detach();
<a name="l01051"></a>01051 
<a name="l01052"></a>01052   s &gt;&gt; a.mData-&gt;uid;
<a name="l01053"></a>01053 
<a name="l01054"></a>01054   --STREAMIN--
<a name="l01055"></a>01055   s &gt;&gt; a.mData-&gt;phoneNumbers;
<a name="l01056"></a>01056   s &gt;&gt; a.mData-&gt;addresses;
<a name="l01057"></a>01057   s &gt;&gt; a.mData-&gt;emails;
<a name="l01058"></a>01058   s &gt;&gt; a.mData-&gt;categories;
<a name="l01059"></a>01059   s &gt;&gt; a.mData-&gt;custom;
<a name="l01060"></a>01060   s &gt;&gt; a.mData-&gt;keys;
<a name="l01061"></a>01061 
<a name="l01062"></a>01062   a.mData-&gt;empty = <span class="keyword">false</span>;
<a name="l01063"></a>01063 
<a name="l01064"></a>01064   <span class="keywordflow">return</span> s;
<a name="l01065"></a>01065 }
<a name="l01066"></a>01066 
<a name="l01067"></a>01067 <span class="keywordtype">bool</span> matchBinaryPattern( <span class="keywordtype">int</span> value, <span class="keywordtype">int</span> pattern )
<a name="l01068"></a>01068 {
<a name="l01075"></a>01075   <span class="keywordflow">if</span> ( pattern == 0 )
<a name="l01076"></a>01076     <span class="keywordflow">return</span> ( value == 0 );
<a name="l01077"></a>01077   <span class="keywordflow">else</span>
<a name="l01078"></a>01078     <span class="keywordflow">return</span> ( pattern == ( pattern &amp; value ) );
<a name="l01079"></a>01079 }
<a name="l01080"></a>01080 
<a name="l01081"></a>01081 <span class="keyword">template</span> &lt;<span class="keyword">class</span> L&gt;
<a name="l01082"></a>01082 <span class="keywordtype">bool</span> listEquals( <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList&lt;L&gt;</a> &amp;list, <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList&lt;L&gt;</a> &amp;pattern )
<a name="l01083"></a>01083 {
<a name="l01084"></a>01084   <span class="keywordflow">if</span> ( list.<a class="codeRef" href="qvaluelist.html#count">count</a>() != pattern.<a class="codeRef" href="qvaluelist.html#count">count</a>() )
<a name="l01085"></a>01085     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01086"></a>01086 
<a name="l01087"></a>01087   <span class="keywordflow">for</span> ( uint i = 0; i &lt; list.<a class="codeRef" href="qvaluelist.html#count">count</a>(); ++i )
<a name="l01088"></a>01088     <span class="keywordflow">if</span> ( pattern.<a class="codeRef" href="qvaluelist.html#find">find</a>( list[ i ] ) == pattern.<a class="codeRef" href="qvaluelist.html#end">end</a>() )
<a name="l01089"></a>01089       <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01090"></a>01090 
<a name="l01091"></a>01091   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01092"></a>01092 }
<a name="l01093"></a>01093 
<a name="l01094"></a>01094 <span class="keywordtype">bool</span> emailsEquals( <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &amp;list, <span class="keyword">const</span> <a class="codeRef" href="qstringlist.html">QStringList</a> &amp;pattern )
<a name="l01095"></a>01095 {
<a name="l01096"></a>01096   <span class="keywordflow">if</span> ( list.count() != pattern.count() )
<a name="l01097"></a>01097     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01098"></a>01098 
<a name="l01099"></a>01099   <span class="keywordflow">if</span> ( list.first() != pattern.first() )
<a name="l01100"></a>01100     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01101"></a>01101 
<a name="l01102"></a>01102   QStringList::ConstIterator it;
<a name="l01103"></a>01103   <span class="keywordflow">for</span> ( it = list.begin(); it != list.end(); ++it )
<a name="l01104"></a>01104     <span class="keywordflow">if</span> ( pattern.find( *it ) == pattern.end() )
<a name="l01105"></a>01105       <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01106"></a>01106 
<a name="l01107"></a>01107   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01108"></a>01108 }
</pre></div></div>
</div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kabc</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKABC_1_1Address.html">kabc::address</option>,  <option value="classKABC_1_1AddressBook.html">kabc::addressbook</option>,  <option value="classKABC_1_1AddressBook_1_1ConstIterator.html">kabc::addressbook::constiterator</option>,  <option value="classKABC_1_1AddressBook_1_1Iterator.html">kabc::addressbook::iterator</option>,  <option value="classKABC_1_1Addressee.html">kabc::addressee</option>,  <option value="classKABC_1_1AddresseeDialog.html">kabc::addresseedialog</option>,  <option value="classKABC_1_1AddresseeItem.html">kabc::addresseeitem</option>,  <option value="classKABC_1_1AddresseeList.html">kabc::addresseelist</option>,  <option value="classKABC_1_1AddressLineEdit.html">kabc::addresslineedit</option>,  <option value="classKABC_1_1Agent.html">kabc::agent</option>,  <option value="classKABC_1_1BinaryFormat.html">kabc::binaryformat</option>,  <option value="classKABC_1_1ConsoleErrorHandler.html">kabc::consoleerrorhandler</option>,  <option value="classKABC_1_1DistributionList.html">kabc::distributionlist</option>,  <option value="classKABC_1_1DistributionListDialog.html">kabc::distributionlistdialog</option>,  <option value="classKABC_1_1DistributionListEditor.html">kabc::distributionlisteditor</option>,  <option value="classKABC_1_1DistributionListEditorWidget.html">kabc::distributionlisteditorwidget</option>,  <option value="classKABC_1_1DistributionListManager.html">kabc::distributionlistmanager</option>,  <option value="classKABC_1_1DistributionListWatcher.html">kabc::distributionlistwatcher</option>,  <option value="classKABC_1_1EmailSelector.html">kabc::emailselector</option>,  <option value="classKABC_1_1ErrorHandler.html">kabc::errorhandler</option>,  <option value="classKABC_1_1Format.html">kabc::format</option>,  <option value="classKABC_1_1FormatFactory.html">kabc::formatfactory</option>,  <option value="classKABC_1_1FormatPlugin.html">kabc::formatplugin</option>,  <option value="classKABC_1_1Geo.html">kabc::geo</option>,  <option value="classKABC_1_1GUIErrorHandler.html">kabc::guierrorhandler</option>,  <option value="classKABC_1_1GuiErrorHandler.html">kabc::guierrorhandler</option>,  <option value="classKABC_1_1Key.html">kabc::key</option>,  <option value="classKABC_1_1LdapClient.html">kabc::ldapclient</option>,  <option value="classKABC_1_1LdapConfigWidget.html">kabc::ldapconfigwidget</option>,  <option value="classKABC_1_1LdapObject.html">kabc::ldapobject</option>,  <option value="classKABC_1_1LdapSearch.html">kabc::ldapsearch</option>,  <option value="classKABC_1_1LDAPUrl.html">kabc::ldapurl</option>,  <option value="classKABC_1_1LDIF.html">kabc::ldif</option>,  <option value="classKABC_1_1Lock.html">kabc::lock</option>,  <option value="classKABC_1_1LockNull.html">kabc::locknull</option>,  <option value="classKABC_1_1PhoneNumber.html">kabc::phonenumber</option>,  <option value="classKABC_1_1Resource_1_1ConstIterator.html">kabc::resource::constiterator</option>,  <option value="classKABC_1_1Resource_1_1Iterator.html">kabc::resource::iterator</option>,  <option value="classKABC_1_1ResourceFile.html">kabc::resourcefile</option>,  <option value="classKABC_1_1ResourceSelectDialog.html">kabc::resourceselectdialog</option>,  <option value="classKABC_1_1SortMode.html">kabc::sortmode</option>,  <option value="classKABC_1_1Sound.html">kabc::sound</option>,  <option value="classKABC_1_1StdAddressBook.html">kabc::stdaddressbook</option>,  <option value="classKABC_1_1Ticket.html">kabc::ticket</option>,  <option value="classKABC_1_1TimeZone.html">kabc::timezone</option>,  <option value="classKABC_1_1VCard21Parser.html">kabc::vcard21parser</option>,  <option value="classKABC_1_1VCardConverter.html">kabc::vcardconverter</option>,  <option value="classKABC_1_1VCardFormat.html">kabc::vcardformat</option>,  <option value="classKABC_1_1VCardFormatImpl.html">kabc::vcardformatimpl</option>,  <option value="classKABC_1_1VCardFormatPlugin.html">kabc::vcardformatplugin</option>,  <option value="classVCard21ParserImpl.html">vcard21parserimpl</option>,  <option value="classVCardLineX.html">vcardlinex</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li>&nbsp;&nbsp;<a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li>&nbsp;&nbsp;<a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li>&nbsp;&nbsp;<a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li>&nbsp;&nbsp;<a href="../../kio/kfile/html/index.html">kfile</a></li><li>&nbsp;&nbsp;<a href="../../kio/kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../kio/kioexec/html/index.html">kioexec</a></li><li>&nbsp;&nbsp;<a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li>&nbsp;&nbsp;<a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li>&nbsp;&nbsp;<a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li>&nbsp;&nbsp;<a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>