addressee.cpp

00001 /*** Warning! This file has been generated by the script makeaddressee ***/
00002 /*
00003     This file is part of libkabc.
00004     Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
00005     Copyright (c) 2003 Carsten Pfeiffer <pfeiffer@kde.org>
00006     Copyright (c) 2005 Ingo Kloecker <kloecker@kde.org>
00007 
00008     This library is free software; you can redistribute it and/or
00009     modify it under the terms of the GNU Library General Public
00010     License as published by the Free Software Foundation; either
00011     version 2 of the License, or (at your option) any later version.
00012 
00013     This library is distributed in the hope that it will be useful,
00014     but WITHOUT ANY WARRANTY; without even the implied warranty of
00015     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00016     Library General Public License for more details.
00017 
00018     You should have received a copy of the GNU Library General Public License
00019     along with this library; see the file COPYING.LIB.  If not, write to
00020     the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00021     Boston, MA 02110-1301, USA.
00022 */
00023 
00024 #include <qregexp.h>
00025 
00026 #include <ksharedptr.h>
00027 #include <kdebug.h>
00028 #include <kapplication.h>
00029 #include <klocale.h>
00030 
00031 #include "addresseehelper.h"
00032 #include "field.h"
00033 #include "resource.h"
00034 #include "sortmode.h"
00035 
00036 #include "addressee.h"
00037 
00038 using namespace KABC;
00039 
00040 static bool matchBinaryPattern( int value, int pattern );
00041 
00042 template <class L>
00043 static bool listEquals( const QValueList<L>&, const QValueList<L>& );
00044 static bool emailsEquals( const QStringList&, const QStringList& );
00045 
00046 KABC::SortMode *Addressee::mSortMode = 0;
00047 
00048 struct Addressee::AddresseeData : public KShared
00049 {
00050   QString uid;
00051   QString name;
00052   QString formattedName;
00053   QString familyName;
00054   QString givenName;
00055   QString additionalName;
00056   QString prefix;
00057   QString suffix;
00058   QString nickName;
00059   QDateTime birthday;
00060   QString mailer;
00061   TimeZone timeZone;
00062   Geo geo;
00063   QString title;
00064   QString role;
00065   QString organization;
00066   QString department;
00067   QString note;
00068   QString productId;
00069   QDateTime revision;
00070   QString sortString;
00071   KURL url;
00072   Secrecy secrecy;
00073   Picture logo;
00074   Picture photo;
00075   Sound sound;
00076   Agent agent;
00077 
00078   PhoneNumber::List phoneNumbers;
00079   Address::List addresses;
00080   Key::List keys;
00081   QStringList emails;
00082   QStringList categories;
00083   QStringList custom;
00084 
00085   Resource *resource;
00086 
00087   bool empty    :1;
00088   bool changed  :1;
00089 };
00090 
00091 Addressee::AddresseeData* Addressee::shared_null = 0;
00092 
00093 Addressee::AddresseeData* Addressee::makeSharedNull()
00094 {
00095   Addressee::shared_null = new AddresseeData;
00096   shared_null->_KShared_ref(); //just in case (we should add KSD)
00097   shared_null->empty = true;
00098   shared_null->changed = false;
00099   shared_null->resource = 0;
00100   return shared_null;
00101 }
00102 
00103 Addressee::Addressee()
00104 {
00105   mData = shared_null ? shared_null : makeSharedNull();
00106 }
00107 
00108 Addressee::~Addressee()
00109 {
00110 }
00111 
00112 Addressee::Addressee( const Addressee &a )
00113 {
00114   mData = a.mData;
00115 }
00116 
00117 Addressee &Addressee::operator=( const Addressee &a )
00118 {
00119   if ( this == &a )
00120     return (*this);
00121 
00122   mData = a.mData;
00123   return (*this);
00124 }
00125 
00126 void Addressee::detach()
00127 {
00128   if ( mData.data() == shared_null ) {
00129     mData = new AddresseeData;
00130     mData->empty = true;
00131     mData->changed = false;
00132     mData->resource = 0;
00133     mData->uid = KApplication::randomString( 10 );
00134     return;
00135   } else if ( mData.count() == 1 ) return;
00136 
00137   AddresseeData data = *mData;
00138   mData = new AddresseeData( data );
00139 }
00140 
00141 bool Addressee::operator==( const Addressee &a ) const
00142 {
00143   if ( uid() != a.uid() ) {
00144     kdDebug(5700) << "uid differs" << endl;
00145     return false;
00146   }
00147   if ( mData->name != a.mData->name &&
00148      !( mData->name.isEmpty() && a.mData->name.isEmpty() ) ) {
00149     kdDebug(5700) << "name differs" << endl;
00150     return false;
00151   }
00152   if ( mData->formattedName != a.mData->formattedName &&
00153      !( mData->formattedName.isEmpty() && a.mData->formattedName.isEmpty() ) ) {
00154     kdDebug(5700) << "formattedName differs" << endl;
00155     return false;
00156   }
00157   if ( mData->familyName != a.mData->familyName &&
00158      !( mData->familyName.isEmpty() && a.mData->familyName.isEmpty() ) ) {
00159     kdDebug(5700) << "familyName differs" << endl;
00160     return false;
00161   }
00162   if ( mData->givenName != a.mData->givenName &&
00163      !( mData->givenName.isEmpty() && a.mData->givenName.isEmpty() ) ) {
00164     kdDebug(5700) << "givenName differs" << endl;
00165     return false;
00166   }
00167   if ( mData->additionalName != a.mData->additionalName &&
00168      !( mData->additionalName.isEmpty() && a.mData->additionalName.isEmpty() ) ) {
00169     kdDebug(5700) << "additionalName differs" << endl;
00170     return false;
00171   }
00172   if ( mData->prefix != a.mData->prefix &&
00173      !( mData->prefix.isEmpty() && a.mData->prefix.isEmpty() ) ) {
00174     kdDebug(5700) << "prefix differs" << endl;
00175     return false;
00176   }
00177   if ( mData->suffix != a.mData->suffix &&
00178      !( mData->suffix.isEmpty() && a.mData->suffix.isEmpty() ) ) {
00179     kdDebug(5700) << "suffix differs" << endl;
00180     return false;
00181   }
00182   if ( mData->nickName != a.mData->nickName &&
00183      !( mData->nickName.isEmpty() && a.mData->nickName.isEmpty() ) ) {
00184     kdDebug(5700) << "nickName differs" << endl;
00185     return false;
00186   }
00187   if ( mData->birthday != a.mData->birthday ) {
00188     kdDebug(5700) << "birthday differs" << endl;
00189     return false;
00190   }
00191   if ( mData->mailer != a.mData->mailer &&
00192      !( mData->mailer.isEmpty() && a.mData->mailer.isEmpty() ) ) {
00193     kdDebug(5700) << "mailer differs" << endl;
00194     return false;
00195   }
00196   if ( mData->timeZone != a.mData->timeZone ) {
00197     kdDebug(5700) << "timeZone differs" << endl;
00198     return false;
00199   }
00200   if ( mData->geo != a.mData->geo ) {
00201     kdDebug(5700) << "geo differs" << endl;
00202     return false;
00203   }
00204   if ( mData->title != a.mData->title &&
00205      !( mData->title.isEmpty() && a.mData->title.isEmpty() ) ) {
00206     kdDebug(5700) << "title differs" << endl;
00207     return false;
00208   }
00209   if ( mData->role != a.mData->role &&
00210      !( mData->role.isEmpty() && a.mData->role.isEmpty() ) ) {
00211     kdDebug(5700) << "role differs" << endl;
00212     return false;
00213   }
00214   if ( mData->organization != a.mData->organization &&
00215      !( mData->organization.isEmpty() && a.mData->organization.isEmpty() ) ) {
00216     kdDebug(5700) << "organization differs" << endl;
00217     return false;
00218   }
00219   if ( mData->department != a.mData->department &&
00220      !( mData->department.isEmpty() && a.mData->department.isEmpty() ) ) {
00221     kdDebug(5700) << "department differs" << endl;
00222     return false;
00223   }
00224   if ( mData->note != a.mData->note &&
00225      !( mData->note.isEmpty() && a.mData->note.isEmpty() ) ) {
00226     kdDebug(5700) << "note differs" << endl;
00227     return false;
00228   }
00229   if ( mData->productId != a.mData->productId &&
00230      !( mData->productId.isEmpty() && a.mData->productId.isEmpty() ) ) {
00231     kdDebug(5700) << "productId differs" << endl;
00232     return false;
00233   }
00234   if ( mData->sortString != a.mData->sortString &&
00235      !( mData->sortString.isEmpty() && a.mData->sortString.isEmpty() ) ) {
00236     kdDebug(5700) << "sortString differs" << endl;
00237     return false;
00238   }
00239   if ( mData->secrecy != a.mData->secrecy ) {
00240     kdDebug(5700) << "secrecy differs" << endl;
00241     return false;
00242   }
00243   if ( mData->logo != a.mData->logo ) {
00244     kdDebug(5700) << "logo differs" << endl;
00245     return false;
00246   }
00247   if ( mData->photo != a.mData->photo ) {
00248     kdDebug(5700) << "photo differs" << endl;
00249     return false;
00250   }
00251   if ( mData->sound != a.mData->sound ) {
00252     kdDebug(5700) << "sound differs" << endl;
00253     return false;
00254   }
00255   if ( mData->agent != a.mData->agent ) {
00256     kdDebug(5700) << "agent differs" << endl;
00257     return false;
00258   }
00259   if ( ( mData->url.isValid() || a.mData->url.isValid() ) &&
00260        ( mData->url != a.mData->url ) ) {
00261     kdDebug(5700) << "url differs" << endl;
00262     return false;
00263   }
00264   if ( !listEquals( mData->phoneNumbers, a.mData->phoneNumbers ) ) {
00265     kdDebug(5700) << "phoneNumbers differs" << endl;
00266     return false;
00267   }
00268   if ( !listEquals( mData->addresses, a.mData->addresses ) ) {
00269     kdDebug(5700) << "addresses differs" << endl;
00270     return false;
00271   }
00272   if ( !listEquals( mData->keys, a.mData->keys ) ) {
00273     kdDebug(5700) << "keys differs" << endl;
00274     return false;
00275   }
00276   if ( !emailsEquals( mData->emails, a.mData->emails ) ) {
00277     kdDebug(5700) << "emails differs" << endl;
00278     return false;
00279   }
00280   if ( !listEquals( mData->categories, a.mData->categories ) ) {
00281     kdDebug(5700) << "categories differs" << endl;
00282     return false;
00283   }
00284   if ( !listEquals( mData->custom, a.mData->custom ) ) {
00285     kdDebug(5700) << "custom differs" << endl;
00286     return false;
00287   }
00288 
00289   return true;
00290 }
00291 
00292 bool Addressee::operator!=( const Addressee &a ) const
00293 {
00294   return !( a == *this );
00295 }
00296 
00297 bool Addressee::isEmpty() const
00298 {
00299   return mData->empty;
00300 }
00301 
00302 void Addressee::setUid( const QString &id )
00303 {
00304   if ( id == mData->uid ) return;
00305   detach();
00306   mData->empty = false;
00307   mData->uid = id;
00308 }
00309 
00310 QString Addressee::uid() const
00311 {
00312   return mData->uid;
00313 }
00314 
00315 QString Addressee::uidLabel()
00316 {
00317   return i18n("Unique Identifier");
00318 }
00319 
00320 void Addressee::setName( const QString &name )
00321 {
00322   if ( name == mData->name ) return;
00323   detach();
00324   mData->empty = false;
00325   mData->name = name;
00326 }
00327 
00328 QString Addressee::name() const
00329 {
00330   return mData->name;
00331 }
00332 
00333 QString Addressee::nameLabel()
00334 {
00335   return i18n("Name");
00336 }
00337 
00338 
00339 void Addressee::setFormattedName( const QString &formattedName )
00340 {
00341   if ( formattedName == mData->formattedName ) return;
00342   detach();
00343   mData->empty = false;
00344   mData->formattedName = formattedName;
00345 }
00346 
00347 QString Addressee::formattedName() const
00348 {
00349   return mData->formattedName;
00350 }
00351 
00352 QString Addressee::formattedNameLabel()
00353 {
00354   return i18n("Formatted Name");
00355 }
00356 
00357 
00358 void Addressee::setFamilyName( const QString &familyName )
00359 {
00360   if ( familyName == mData->familyName ) return;
00361   detach();
00362   mData->empty = false;
00363   mData->familyName = familyName;
00364 }
00365 
00366 QString Addressee::familyName() const
00367 {
00368   return mData->familyName;
00369 }
00370 
00371 QString Addressee::familyNameLabel()
00372 {
00373   return i18n("Family Name");
00374 }
00375 
00376 
00377 void Addressee::setGivenName( const QString &givenName )
00378 {
00379   if ( givenName == mData->givenName ) return;
00380   detach();
00381   mData->empty = false;
00382   mData->givenName = givenName;
00383 }
00384 
00385 QString Addressee::givenName() const
00386 {
00387   return mData->givenName;
00388 }
00389 
00390 QString Addressee::givenNameLabel()
00391 {
00392   return i18n("Given Name");
00393 }
00394 
00395 
00396 void Addressee::setAdditionalName( const QString &additionalName )
00397 {
00398   if ( additionalName == mData->additionalName ) return;
00399   detach();
00400   mData->empty = false;
00401   mData->additionalName = additionalName;
00402 }
00403 
00404 QString Addressee::additionalName() const
00405 {
00406   return mData->additionalName;
00407 }
00408 
00409 QString Addressee::additionalNameLabel()
00410 {
00411   return i18n("Additional Names");
00412 }
00413 
00414 
00415 void Addressee::setPrefix( const QString &prefix )
00416 {
00417   if ( prefix == mData->prefix ) return;
00418   detach();
00419   mData->empty = false;
00420   mData->prefix = prefix;
00421 }
00422 
00423 QString Addressee::prefix() const
00424 {
00425   return mData->prefix;
00426 }
00427 
00428 QString Addressee::prefixLabel()
00429 {
00430   return i18n("Honorific Prefixes");
00431 }
00432 
00433 
00434 void Addressee::setSuffix( const QString &suffix )
00435 {
00436   if ( suffix == mData->suffix ) return;
00437   detach();
00438   mData->empty = false;
00439   mData->suffix = suffix;
00440 }
00441 
00442 QString Addressee::suffix() const
00443 {
00444   return mData->suffix;
00445 }
00446 
00447 QString Addressee::suffixLabel()
00448 {
00449   return i18n("Honorific Suffixes");
00450 }
00451 
00452 
00453 void Addressee::setNickName( const QString &nickName )
00454 {
00455   if ( nickName == mData->nickName ) return;
00456   detach();
00457   mData->empty = false;
00458   mData->nickName = nickName;
00459 }
00460 
00461 QString Addressee::nickName() const
00462 {
00463   return mData->nickName;
00464 }
00465 
00466 QString Addressee::nickNameLabel()
00467 {
00468   return i18n("Nick Name");
00469 }
00470 
00471 
00472 void Addressee::setBirthday( const QDateTime &birthday )
00473 {
00474   if ( birthday == mData->birthday ) return;
00475   detach();
00476   mData->empty = false;
00477   mData->birthday = birthday;
00478 }
00479 
00480 QDateTime Addressee::birthday() const
00481 {
00482   return mData->birthday;
00483 }
00484 
00485 QString Addressee::birthdayLabel()
00486 {
00487   return i18n("Birthday");
00488 }
00489 
00490 
00491 QString Addressee::homeAddressStreetLabel()
00492 {
00493   return i18n("Home Address Street");
00494 }
00495 
00496 
00497 QString Addressee::homeAddressLocalityLabel()
00498 {
00499   return i18n("Home Address City");
00500 }
00501 
00502 
00503 QString Addressee::homeAddressRegionLabel()
00504 {
00505   return i18n("Home Address State");
00506 }
00507 
00508 
00509 QString Addressee::homeAddressPostalCodeLabel()
00510 {
00511   return i18n("Home Address Zip Code");
00512 }
00513 
00514 
00515 QString Addressee::homeAddressCountryLabel()
00516 {
00517   return i18n("Home Address Country");
00518 }
00519 
00520 
00521 QString Addressee::homeAddressLabelLabel()
00522 {
00523   return i18n("Home Address Label");
00524 }
00525 
00526 
00527 QString Addressee::businessAddressStreetLabel()
00528 {
00529   return i18n("Business Address Street");
00530 }
00531 
00532 
00533 QString Addressee::businessAddressLocalityLabel()
00534 {
00535   return i18n("Business Address City");
00536 }
00537 
00538 
00539 QString Addressee::businessAddressRegionLabel()
00540 {
00541   return i18n("Business Address State");
00542 }
00543 
00544 
00545 QString Addressee::businessAddressPostalCodeLabel()
00546 {
00547   return i18n("Business Address Zip Code");
00548 }
00549 
00550 
00551 QString Addressee::businessAddressCountryLabel()
00552 {
00553   return i18n("Business Address Country");
00554 }
00555 
00556 
00557 QString Addressee::businessAddressLabelLabel()
00558 {
00559   return i18n("Business Address Label");
00560 }
00561 
00562 
00563 QString Addressee::homePhoneLabel()
00564 {
00565   return i18n("Home Phone");
00566 }
00567 
00568 
00569 QString Addressee::businessPhoneLabel()
00570 {
00571   return i18n("Business Phone");
00572 }
00573 
00574 
00575 QString Addressee::mobilePhoneLabel()
00576 {
00577   return i18n("Mobile Phone");
00578 }
00579 
00580 
00581 QString Addressee::homeFaxLabel()
00582 {
00583   return i18n("Home Fax");
00584 }
00585 
00586 
00587 QString Addressee::businessFaxLabel()
00588 {
00589   return i18n("Business Fax");
00590 }
00591 
00592 
00593 QString Addressee::carPhoneLabel()
00594 {
00595   return i18n("Car Phone");
00596 }
00597 
00598 
00599 QString Addressee::isdnLabel()
00600 {
00601   return i18n("ISDN");
00602 }
00603 
00604 
00605 QString Addressee::pagerLabel()
00606 {
00607   return i18n("Pager");
00608 }
00609 
00610 
00611 QString Addressee::emailLabel()
00612 {
00613   return i18n("Email Address");
00614 }
00615 
00616 
00617 void Addressee::setMailer( const QString &mailer )
00618 {
00619   if ( mailer == mData->mailer ) return;
00620   detach();
00621   mData->empty = false;
00622   mData->mailer = mailer;
00623 }
00624 
00625 QString Addressee::mailer() const
00626 {
00627   return mData->mailer;
00628 }
00629 
00630 QString Addressee::mailerLabel()
00631 {
00632   return i18n("Mail Client");
00633 }
00634 
00635 
00636 void Addressee::setTimeZone( const TimeZone &timeZone )
00637 {
00638   if ( timeZone == mData->timeZone ) return;
00639   detach();
00640   mData->empty = false;
00641   mData->timeZone = timeZone;
00642 }
00643 
00644 TimeZone Addressee::timeZone() const
00645 {
00646   return mData->timeZone;
00647 }
00648 
00649 QString Addressee::timeZoneLabel()
00650 {
00651   return i18n("Time Zone");
00652 }
00653 
00654 
00655 void Addressee::setGeo( const Geo &geo )
00656 {
00657   if ( geo == mData->geo ) return;
00658   detach();
00659   mData->empty = false;
00660   mData->geo = geo;
00661 }
00662 
00663 Geo Addressee::geo() const
00664 {
00665   return mData->geo;
00666 }
00667 
00668 QString Addressee::geoLabel()
00669 {
00670   return i18n("Geographic Position");
00671 }
00672 
00673 
00674 void Addressee::setTitle( const QString &title )
00675 {
00676   if ( title == mData->title ) return;
00677   detach();
00678   mData->empty = false;
00679   mData->title = title;
00680 }
00681 
00682 QString Addressee::title() const
00683 {
00684   return mData->title;
00685 }
00686 
00687 QString Addressee::titleLabel()
00688 {
00689   return i18n("person","Title");
00690 }
00691 
00692 
00693 void Addressee::setRole( const QString &role )
00694 {
00695   if ( role == mData->role ) return;
00696   detach();
00697   mData->empty = false;
00698   mData->role = role;
00699 }
00700 
00701 QString Addressee::role() const
00702 {
00703   return mData->role;
00704 }
00705 
00706 QString Addressee::roleLabel()
00707 {
00708   return i18n("person in organization","Role");
00709 }
00710 
00711 
00712 void Addressee::setOrganization( const QString &organization )
00713 {
00714   if ( organization == mData->organization ) return;
00715   detach();
00716   mData->empty = false;
00717   mData->organization = organization;
00718 }
00719 
00720 QString Addressee::organization() const
00721 {
00722   return mData->organization;
00723 }
00724 
00725 QString Addressee::organizationLabel()
00726 {
00727   return i18n("Organization");
00728 }
00729 
00730 
00731 void Addressee::setDepartment( const QString &department )
00732 {
00733   if ( department == mData->department ) return;
00734   detach();
00735   mData->empty = false;
00736   mData->department = department;
00737 }
00738 
00739 QString Addressee::department() const
00740 {
00741   return mData->department;
00742 }
00743 
00744 QString Addressee::departmentLabel()
00745 {
00746   return i18n("Department");
00747 }
00748 
00749 
00750 void Addressee::setNote( const QString &note )
00751 {
00752   if ( note == mData->note ) return;
00753   detach();
00754   mData->empty = false;
00755   mData->note = note;
00756 }
00757 
00758 QString Addressee::note() const
00759 {
00760   return mData->note;
00761 }
00762 
00763 QString Addressee::noteLabel()
00764 {
00765   return i18n("Note");
00766 }
00767 
00768 
00769 void Addressee::setProductId( const QString &productId )
00770 {
00771   if ( productId == mData->productId ) return;
00772   detach();
00773   mData->empty = false;
00774   mData->productId = productId;
00775 }
00776 
00777 QString Addressee::productId() const
00778 {
00779   return mData->productId;
00780 }
00781 
00782 QString Addressee::productIdLabel()
00783 {
00784   return i18n("Product Identifier");
00785 }
00786 
00787 
00788 void Addressee::setRevision( const QDateTime &revision )
00789 {
00790   if ( revision == mData->revision ) return;
00791   detach();
00792   mData->empty = false;
00793   mData->revision = revision;
00794 }
00795 
00796 QDateTime Addressee::revision() const
00797 {
00798   return mData->revision;
00799 }
00800 
00801 QString Addressee::revisionLabel()
00802 {
00803   return i18n("Revision Date");
00804 }
00805 
00806 
00807 void Addressee::setSortString( const QString &sortString )
00808 {
00809   if ( sortString == mData->sortString ) return;
00810   detach();
00811   mData->empty = false;
00812   mData->sortString = sortString;
00813 }
00814 
00815 QString Addressee::sortString() const
00816 {
00817   return mData->sortString;
00818 }
00819 
00820 QString Addressee::sortStringLabel()
00821 {
00822   return i18n("Sort String");
00823 }
00824 
00825 
00826 void Addressee::setUrl( const KURL &url )
00827 {
00828   if ( url == mData->url ) return;
00829   detach();
00830   mData->empty = false;
00831   mData->url = url;
00832 }
00833 
00834 KURL Addressee::url() const
00835 {
00836   return mData->url;
00837 }
00838 
00839 QString Addressee::urlLabel()
00840 {
00841   return i18n("Homepage");
00842 }
00843 
00844 
00845 void Addressee::setSecrecy( const Secrecy &secrecy )
00846 {
00847   if ( secrecy == mData->secrecy ) return;
00848   detach();
00849   mData->empty = false;
00850   mData->secrecy = secrecy;
00851 }
00852 
00853 Secrecy Addressee::secrecy() const
00854 {
00855   return mData->secrecy;
00856 }
00857 
00858 QString Addressee::secrecyLabel()
00859 {
00860   return i18n("Security Class");
00861 }
00862 
00863 
00864 void Addressee::setLogo( const Picture &logo )
00865 {
00866   if ( logo == mData->logo ) return;
00867   detach();
00868   mData->empty = false;
00869   mData->logo = logo;
00870 }
00871 
00872 Picture Addressee::logo() const
00873 {
00874   return mData->logo;
00875 }
00876 
00877 QString Addressee::logoLabel()
00878 {
00879   return i18n("Logo");
00880 }
00881 
00882 
00883 void Addressee::setPhoto( const Picture &photo )
00884 {
00885   if ( photo == mData->photo ) return;
00886   detach();
00887   mData->empty = false;
00888   mData->photo = photo;
00889 }
00890 
00891 Picture Addressee::photo() const
00892 {
00893   return mData->photo;
00894 }
00895 
00896 QString Addressee::photoLabel()
00897 {
00898   return i18n("Photo");
00899 }
00900 
00901 
00902 void Addressee::setSound( const Sound &sound )
00903 {
00904   if ( sound == mData->sound ) return;
00905   detach();
00906   mData->empty = false;
00907   mData->sound = sound;
00908 }
00909 
00910 Sound Addressee::sound() const
00911 {
00912   return mData->sound;
00913 }
00914 
00915 QString Addressee::soundLabel()
00916 {
00917   return i18n("Sound");
00918 }
00919 
00920 
00921 void Addressee::setAgent( const Agent &agent )
00922 {
00923   if ( agent == mData->agent ) return;
00924   detach();
00925   mData->empty = false;
00926   mData->agent = agent;
00927 }
00928 
00929 Agent Addressee::agent() const
00930 {
00931   return mData->agent;
00932 }
00933 
00934 QString Addressee::agentLabel()
00935 {
00936   return i18n("Agent");
00937 }
00938 
00939 
00940 
00941 void Addressee::setNameFromString( const QString &s )
00942 {
00943   QString str = s;
00944   //remove enclosing quotes from string
00945   if ( str.length() > 1  && s[ 0 ] == '"' && s[ s.length() - 1 ] == '"' )
00946     str = s.mid( 1, s.length() - 2 );
00947 
00948   setFormattedName( str );
00949   setName( str );
00950 
00951   // clear all name parts
00952   setPrefix( QString::null );
00953   setGivenName( QString::null );
00954   setAdditionalName( QString::null );
00955   setFamilyName( QString::null );
00956   setSuffix( QString::null );
00957 
00958   if ( str.isEmpty() )
00959     return;
00960 
00961   QString spaceStr = " ";
00962   QString emptyStr = "";
00963   AddresseeHelper *helper = AddresseeHelper::self();
00964 
00965   int i = str.find( ',' );
00966   if( i < 0 ) {
00967     QStringList parts = QStringList::split( spaceStr, str );
00968     int leftOffset = 0;
00969     int rightOffset = parts.count() - 1;
00970 
00971     QString suffix;
00972     while ( rightOffset >= 0 ) {
00973       if ( helper->containsSuffix( parts[ rightOffset ] ) ) {
00974         suffix.prepend(parts[ rightOffset ] + (suffix.isEmpty() ? emptyStr : spaceStr));
00975         rightOffset--;
00976       } else
00977         break;
00978     }
00979     setSuffix( suffix );
00980 
00981     if ( rightOffset < 0 )
00982       return;
00983 
00984     QStringList inclusionList;
00985     for ( int n = 1; (rightOffset - n >= 0) && (n < 4); ++n ) {
00986       if ( helper->containsPrefix( parts[ rightOffset - n ].lower() ) ) {
00987         inclusionList.prepend( parts[ rightOffset - n ] );
00988       } else
00989         break;
00990     }
00991 
00992     if ( !inclusionList.isEmpty() ) {
00993       setFamilyName( inclusionList.join( " " ) + spaceStr + parts[ rightOffset ] );
00994       rightOffset -= inclusionList.count();
00995     } else {
00996       if ( helper->tradeAsFamilyName() )
00997         setFamilyName( parts[ rightOffset ] );
00998       else
00999         setGivenName( parts[ rightOffset ] );
01000     }
01001 
01002     QString prefix;
01003     while ( leftOffset < rightOffset ) {
01004       if ( helper->containsTitle( parts[ leftOffset ] ) ) {
01005         prefix.append( ( prefix.isEmpty() ? emptyStr : spaceStr) + parts[ leftOffset ] );
01006         leftOffset++;
01007       } else
01008         break;
01009     }
01010     setPrefix( prefix );
01011 
01012     if ( leftOffset < rightOffset ) {
01013       setGivenName( parts[ leftOffset ] );
01014       leftOffset++;
01015     }
01016 
01017     QString additionalName;
01018     while ( leftOffset < rightOffset ) {
01019       additionalName.append( ( additionalName.isEmpty() ? emptyStr : spaceStr) + parts[ leftOffset ] );
01020       leftOffset++;
01021     }
01022     setAdditionalName( additionalName );
01023   } else {
01024     QString part1 = str.left( i );
01025     QString part2 = str.mid( i + 1 );
01026 
01027     QStringList parts = QStringList::split( spaceStr, part1 );
01028     int leftOffset = 0;
01029     int rightOffset = parts.count() - 1;
01030 
01031     if ( parts.count() > 0 ) {
01032 
01033       QString suffix;
01034       while ( rightOffset >= 0 ) {
01035         if ( helper->containsSuffix( parts[ rightOffset ] ) ) {
01036           suffix.prepend(parts[ rightOffset ] + (suffix.isEmpty() ? emptyStr : spaceStr));
01037           rightOffset--;
01038         } else
01039           break;
01040       }
01041       setSuffix( suffix );
01042 
01043       if ( rightOffset - 1 >= 0 && helper->containsPrefix( parts[ rightOffset - 1 ].lower() ) ) {
01044         setFamilyName( parts[ rightOffset - 1 ] + spaceStr + parts[ rightOffset ] );
01045         rightOffset--;
01046       } else
01047         setFamilyName( parts[ rightOffset ] );
01048 
01049       QString prefix;
01050       while ( leftOffset < rightOffset ) {
01051         if ( helper->containsTitle( parts[ leftOffset ] ) ) {
01052           prefix.append( ( prefix.isEmpty() ? emptyStr : spaceStr) + parts[ leftOffset ] );
01053           leftOffset++;
01054         } else
01055           break;
01056       }
01057     } else {
01058       setPrefix( "" );
01059       setFamilyName( "" );
01060       setSuffix( "" );
01061     }
01062 
01063     parts = QStringList::split( spaceStr, part2 );
01064 
01065     leftOffset = 0;
01066     rightOffset = parts.count();
01067 
01068     if ( parts.count() > 0 ) {
01069 
01070       QString prefix;
01071       while ( leftOffset < rightOffset ) {
01072         if ( helper->containsTitle( parts[ leftOffset ] ) ) {
01073           prefix.append( ( prefix.isEmpty() ? emptyStr : spaceStr) + parts[ leftOffset ] );
01074           leftOffset++;
01075         } else
01076           break;
01077       }
01078       setPrefix( prefix );
01079 
01080       if ( leftOffset < rightOffset ) {
01081         setGivenName( parts[ leftOffset ] );
01082         leftOffset++;
01083       }
01084 
01085       QString additionalName;
01086       while ( leftOffset < rightOffset ) {
01087         additionalName.append( ( additionalName.isEmpty() ? emptyStr : spaceStr) + parts[ leftOffset ] );
01088         leftOffset++;
01089       }
01090       setAdditionalName( additionalName );
01091     } else {
01092       setGivenName( "" );
01093       setAdditionalName( "" );
01094     }
01095   }
01096 }
01097 
01098 QString Addressee::realName() const
01099 {
01100   QString n( formattedName() );
01101   if ( !n.isEmpty() )
01102     return n;
01103 
01104   n = assembledName();
01105   if ( !n.isEmpty() )
01106     return n;
01107 
01108   n = name();
01109   if ( !n.isEmpty() )
01110     return n;
01111 
01112   return organization();
01113 }
01114 
01115 QString Addressee::assembledName() const
01116 {
01117   QString name = prefix() + " " + givenName() + " " + additionalName() + " " +
01118               familyName() + " " + suffix();
01119 
01120   return name.simplifyWhiteSpace();
01121 }
01122 
01123 QString Addressee::fullEmail( const QString &email ) const
01124 {
01125   QString e;
01126   if ( email.isNull() ) {
01127     e = preferredEmail();
01128   } else {
01129     e = email;
01130   }
01131   if ( e.isEmpty() ) return QString::null;
01132 
01133   QString text;
01134   if ( realName().isEmpty() )
01135     text = e;
01136   else {
01137     QRegExp needQuotes( "[^ 0-9A-Za-z\\x0080-\\xFFFF]" );
01138     if ( realName().find( needQuotes ) != -1 ) {
01139       QString name = realName();
01140       name.replace( "\"", "\\\"" );
01141       text = "\"" + name + "\" <" + e + ">";
01142     } else
01143       text = realName() + " <" + e + ">";
01144   }
01145 
01146   return text;
01147 }
01148 
01149 void Addressee::insertEmail( const QString &email, bool preferred )
01150 {
01151   if ( email.simplifyWhiteSpace().isEmpty() )
01152     return;
01153 
01154   detach();
01155   mData->empty = false;
01156 
01157   QStringList::Iterator it = mData->emails.find( email );
01158 
01159   if ( it != mData->emails.end() ) {
01160     if ( !preferred || it == mData->emails.begin() ) return;
01161     mData->emails.remove( it );
01162     mData->emails.prepend( email );
01163   } else {
01164     if ( preferred ) {
01165       mData->emails.prepend( email );
01166     } else {
01167       mData->emails.append( email );
01168     }
01169   }
01170 }
01171 
01172 void Addressee::removeEmail( const QString &email )
01173 {
01174   detach();
01175 
01176   QStringList::Iterator it = mData->emails.find( email );
01177   if ( it == mData->emails.end() ) return;
01178 
01179   mData->emails.remove( it );
01180 }
01181 
01182 QString Addressee::preferredEmail() const
01183 {
01184   if ( mData->emails.count() == 0 ) return QString::null;
01185   else return mData->emails.first();
01186 }
01187 
01188 QStringList Addressee::emails() const
01189 {
01190   return mData->emails;
01191 }
01192 void Addressee::setEmails( const QStringList& emails ) {
01193   detach();
01194 
01195   mData->emails = emails;
01196 }
01197 void Addressee::insertPhoneNumber( const PhoneNumber &phoneNumber )
01198 {
01199   detach();
01200   mData->empty = false;
01201 
01202   PhoneNumber::List::Iterator it;
01203   for( it = mData->phoneNumbers.begin(); it != mData->phoneNumbers.end(); ++it ) {
01204     if ( (*it).id() == phoneNumber.id() ) {
01205       *it = phoneNumber;
01206       return;
01207     }
01208   }
01209   if ( !phoneNumber.number().simplifyWhiteSpace().isEmpty() )
01210     mData->phoneNumbers.append( phoneNumber );
01211 }
01212 
01213 void Addressee::removePhoneNumber( const PhoneNumber &phoneNumber )
01214 {
01215   detach();
01216 
01217   PhoneNumber::List::Iterator it;
01218   for( it = mData->phoneNumbers.begin(); it != mData->phoneNumbers.end(); ++it ) {
01219     if ( (*it).id() == phoneNumber.id() ) {
01220       mData->phoneNumbers.remove( it );
01221       return;
01222     }
01223   }
01224 }
01225 
01226 PhoneNumber Addressee::phoneNumber( int type ) const
01227 {
01228   PhoneNumber phoneNumber( "", type );
01229   PhoneNumber::List::ConstIterator it;
01230   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01231     if ( matchBinaryPattern( (*it).type(), type ) ) {
01232       if ( (*it).type() & PhoneNumber::Pref )
01233         return (*it);
01234       else if ( phoneNumber.number().isEmpty() )
01235         phoneNumber = (*it);
01236     }
01237   }
01238 
01239   return phoneNumber;
01240 }
01241 
01242 PhoneNumber::List Addressee::phoneNumbers() const
01243 {
01244   return mData->phoneNumbers;
01245 }
01246 
01247 PhoneNumber::List Addressee::phoneNumbers( int type ) const
01248 {
01249   PhoneNumber::List list;
01250 
01251   PhoneNumber::List::ConstIterator it;
01252   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01253     if ( matchBinaryPattern( (*it).type(), type ) ) {
01254       list.append( *it );
01255     }
01256   }
01257   return list;
01258 }
01259 
01260 PhoneNumber Addressee::findPhoneNumber( const QString &id ) const
01261 {
01262   PhoneNumber::List::ConstIterator it;
01263   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01264     if ( (*it).id() == id ) {
01265       return *it;
01266     }
01267   }
01268   return PhoneNumber();
01269 }
01270 
01271 void Addressee::insertKey( const Key &key )
01272 {
01273   detach();
01274   mData->empty = false;
01275 
01276   Key::List::Iterator it;
01277   for( it = mData->keys.begin(); it != mData->keys.end(); ++it ) {
01278     if ( (*it).id() == key.id() ) {
01279       *it = key;
01280       return;
01281     }
01282   }
01283   mData->keys.append( key );
01284 }
01285 
01286 void Addressee::removeKey( const Key &key )
01287 {
01288   detach();
01289 
01290   Key::List::Iterator it;
01291   for( it = mData->keys.begin(); it != mData->keys.end(); ++it ) {
01292     if ( (*it).id() == key.id() ) {
01293       mData->keys.remove( key );
01294       return;
01295     }
01296   }
01297 }
01298 
01299 Key Addressee::key( int type, QString customTypeString ) const
01300 {
01301   Key::List::ConstIterator it;
01302   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01303     if ( (*it).type() == type ) {
01304       if ( type == Key::Custom ) {
01305         if ( customTypeString.isEmpty() ) {
01306           return *it;
01307         } else {
01308           if ( (*it).customTypeString() == customTypeString )
01309             return (*it);
01310         }
01311       } else {
01312         return *it;
01313       }
01314     }
01315   }
01316   return Key( QString(), type );
01317 }
01318 
01319 void Addressee::setKeys( const Key::List& list )
01320 {
01321   detach();
01322   mData->keys = list;
01323 }
01324 
01325 Key::List Addressee::keys() const
01326 {
01327   return mData->keys;
01328 }
01329 
01330 Key::List Addressee::keys( int type, QString customTypeString ) const
01331 {
01332   Key::List list;
01333 
01334   Key::List::ConstIterator it;
01335   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01336     if ( (*it).type() == type ) {
01337       if ( type == Key::Custom ) {
01338         if ( customTypeString.isEmpty() ) {
01339           list.append( *it );
01340         } else {
01341           if ( (*it).customTypeString() == customTypeString )
01342             list.append( *it );
01343         }
01344       } else {
01345         list.append( *it );
01346       }
01347     }
01348   }
01349   return list;
01350 }
01351 
01352 Key Addressee::findKey( const QString &id ) const
01353 {
01354   Key::List::ConstIterator it;
01355   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01356     if ( (*it).id() == id ) {
01357       return *it;
01358     }
01359   }
01360   return Key();
01361 }
01362 
01363 QString Addressee::asString() const
01364 {
01365   return "Smith, agent Smith...";
01366 }
01367 
01368 void Addressee::dump() const
01369 {
01370   kdDebug(5700) << "Addressee {" << endl;
01371 
01372   kdDebug(5700) << "  Uid: '" << uid() << "'" << endl;
01373 
01374   kdDebug(5700) << "  Name: '" << name() << "'" << endl;
01375   kdDebug(5700) << "  FormattedName: '" << formattedName() << "'" << endl;
01376   kdDebug(5700) << "  FamilyName: '" << familyName() << "'" << endl;
01377   kdDebug(5700) << "  GivenName: '" << givenName() << "'" << endl;
01378   kdDebug(5700) << "  AdditionalName: '" << additionalName() << "'" << endl;
01379   kdDebug(5700) << "  Prefix: '" << prefix() << "'" << endl;
01380   kdDebug(5700) << "  Suffix: '" << suffix() << "'" << endl;
01381   kdDebug(5700) << "  NickName: '" << nickName() << "'" << endl;
01382   kdDebug(5700) << "  Birthday: '" << birthday().toString() << "'" << endl;
01383   kdDebug(5700) << "  Mailer: '" << mailer() << "'" << endl;
01384   kdDebug(5700) << "  TimeZone: '" << timeZone().asString() << "'" << endl;
01385   kdDebug(5700) << "  Geo: '" << geo().asString() << "'" << endl;
01386   kdDebug(5700) << "  Title: '" << title() << "'" << endl;
01387   kdDebug(5700) << "  Role: '" << role() << "'" << endl;
01388   kdDebug(5700) << "  Organization: '" << organization() << "'" << endl;
01389   kdDebug(5700) << "  Department: '" << department() << "'" << endl;
01390   kdDebug(5700) << "  Note: '" << note() << "'" << endl;
01391   kdDebug(5700) << "  ProductId: '" << productId() << "'" << endl;
01392   kdDebug(5700) << "  Revision: '" << revision().toString() << "'" << endl;
01393   kdDebug(5700) << "  SortString: '" << sortString() << "'" << endl;
01394   kdDebug(5700) << "  Url: '" << url().url() << "'" << endl;
01395   kdDebug(5700) << "  Secrecy: '" << secrecy().asString() << "'" << endl;
01396   kdDebug(5700) << "  Logo: '" << logo().asString() << "'" << endl;
01397   kdDebug(5700) << "  Photo: '" << photo().asString() << "'" << endl;
01398   kdDebug(5700) << "  Sound: '" << sound().asString() << "'" << endl;
01399   kdDebug(5700) << "  Agent: '" << agent().asString() << "'" << endl;
01400 
01401   kdDebug(5700) << "  Emails {" << endl;
01402   const QStringList e = emails();
01403   QStringList::ConstIterator it;
01404   for( it = e.begin(); it != e.end(); ++it ) {
01405     kdDebug(5700) << "    " << (*it) << endl;
01406   }
01407   kdDebug(5700) << "  }" << endl;
01408 
01409   kdDebug(5700) << "  PhoneNumbers {" << endl;
01410   const PhoneNumber::List p = phoneNumbers();
01411   PhoneNumber::List::ConstIterator it2;
01412   for( it2 = p.begin(); it2 != p.end(); ++it2 ) {
01413     kdDebug(5700) << "    Type: " << int((*it2).type()) << " Number: " << (*it2).number() << endl;
01414   }
01415   kdDebug(5700) << "  }" << endl;
01416 
01417   const Address::List a = addresses();
01418   Address::List::ConstIterator it3;
01419   for( it3 = a.begin(); it3 != a.end(); ++it3 ) {
01420     (*it3).dump();
01421   }
01422 
01423   kdDebug(5700) << "  Keys {" << endl;
01424   const Key::List k = keys();
01425   Key::List::ConstIterator it4;
01426   for( it4 = k.begin(); it4 != k.end(); ++it4 ) {
01427     kdDebug(5700) << "    Type: " << int((*it4).type()) <<
01428                      " Key: " << (*it4).textData() <<
01429                      " CustomString: " << (*it4).customTypeString() << endl;
01430   }
01431   kdDebug(5700) << "  }" << endl;
01432 
01433   kdDebug(5700) << "}" << endl;
01434 }
01435 
01436 
01437 void Addressee::insertAddress( const Address &address )
01438 {
01439   if ( address.isEmpty() )
01440     return;
01441 
01442   detach();
01443   mData->empty = false;
01444 
01445   Address::List::Iterator it;
01446   for( it = mData->addresses.begin(); it != mData->addresses.end(); ++it ) {
01447     if ( (*it).id() == address.id() ) {
01448       *it = address;
01449       return;
01450     }
01451   }
01452 
01453   mData->addresses.append( address );
01454 }
01455 
01456 void Addressee::removeAddress( const Address &address )
01457 {
01458   detach();
01459 
01460   Address::List::Iterator it;
01461   for( it = mData->addresses.begin(); it != mData->addresses.end(); ++it ) {
01462     if ( (*it).id() == address.id() ) {
01463       mData->addresses.remove( it );
01464       return;
01465     }
01466   }
01467 }
01468 
01469 Address Addressee::address( int type ) const
01470 {
01471   Address address( type );
01472   Address::List::ConstIterator it;
01473   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01474     if ( matchBinaryPattern( (*it).type(), type ) ) {
01475       if ( (*it).type() & Address::Pref )
01476         return (*it);
01477       else if ( address.isEmpty() )
01478         address = (*it);
01479     }
01480   }
01481 
01482   return address;
01483 }
01484 
01485 Address::List Addressee::addresses() const
01486 {
01487   return mData->addresses;
01488 }
01489 
01490 Address::List Addressee::addresses( int type ) const
01491 {
01492   Address::List list;
01493 
01494   Address::List::ConstIterator it;
01495   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01496     if ( matchBinaryPattern( (*it).type(), type ) ) {
01497       list.append( *it );
01498     }
01499   }
01500 
01501   return list;
01502 }
01503 
01504 Address Addressee::findAddress( const QString &id ) const
01505 {
01506   Address::List::ConstIterator it;
01507   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01508     if ( (*it).id() == id ) {
01509       return *it;
01510     }
01511   }
01512   return Address();
01513 }
01514 
01515 void Addressee::insertCategory( const QString &c )
01516 {
01517   detach();
01518   mData->empty = false;
01519 
01520   if ( mData->categories.findIndex( c ) != -1 ) return;
01521 
01522   mData->categories.append( c );
01523 }
01524 
01525 void Addressee::removeCategory( const QString &c )
01526 {
01527   detach();
01528 
01529   QStringList::Iterator it = mData->categories.find( c );
01530   if ( it == mData->categories.end() ) return;
01531 
01532   mData->categories.remove( it );
01533 }
01534 
01535 bool Addressee::hasCategory( const QString &c ) const
01536 {
01537   return ( mData->categories.findIndex( c ) != -1 );
01538 }
01539 
01540 void Addressee::setCategories( const QStringList &c )
01541 {
01542   detach();
01543   mData->empty = false;
01544 
01545   mData->categories = c;
01546 }
01547 
01548 QStringList Addressee::categories() const
01549 {
01550   return mData->categories;
01551 }
01552 
01553 void Addressee::insertCustom( const QString &app, const QString &name,
01554                               const QString &value )
01555 {
01556   if ( value.isEmpty() || name.isEmpty() || app.isEmpty() ) return;
01557 
01558   detach();
01559   mData->empty = false;
01560 
01561   QString qualifiedName = app + "-" + name + ":";
01562 
01563   QStringList::Iterator it;
01564   for( it = mData->custom.begin(); it != mData->custom.end(); ++it ) {
01565     if ( (*it).startsWith( qualifiedName ) ) {
01566       (*it) = qualifiedName + value;
01567       return;
01568     }
01569   }
01570 
01571   mData->custom.append( qualifiedName + value );
01572 }
01573 
01574 void Addressee::removeCustom( const QString &app, const QString &name)
01575 {
01576   detach();
01577 
01578   QString qualifiedName = app + "-" + name + ":";
01579 
01580   QStringList::Iterator it;
01581   for( it = mData->custom.begin(); it != mData->custom.end(); ++it ) {
01582     if ( (*it).startsWith( qualifiedName ) ) {
01583       mData->custom.remove( it );
01584       return;
01585     }
01586   }
01587 }
01588 
01589 QString Addressee::custom( const QString &app, const QString &name ) const
01590 {
01591   QString qualifiedName = app + "-" + name + ":";
01592   QString value;
01593 
01594   QStringList::ConstIterator it;
01595   for( it = mData->custom.constBegin(); it != mData->custom.constEnd(); ++it ) {
01596     if ( (*it).startsWith( qualifiedName ) ) {
01597       value = (*it).mid( (*it).find( ":" ) + 1 );
01598       break;
01599     }
01600   }
01601 
01602   return value;
01603 }
01604 
01605 void Addressee::setCustoms( const QStringList &l )
01606 {
01607   detach();
01608   mData->empty = false;
01609 
01610   mData->custom = l;
01611 }
01612 
01613 QStringList Addressee::customs() const
01614 {
01615   return mData->custom;
01616 }
01617 
01618 void Addressee::parseEmailAddress( const QString &rawEmail, QString &fullName,
01619                                    QString &email)
01620 {
01621   // This is a simplified version of KPIM::splitAddress().
01622 
01623   fullName = "";
01624   email = "";
01625   if ( rawEmail.isEmpty() )
01626     return; // KPIM::AddressEmpty;
01627 
01628   // The code works on 8-bit strings, so convert the input to UTF-8.
01629   QCString address = rawEmail.utf8();
01630 
01631   QCString displayName;
01632   QCString addrSpec;
01633   QCString comment;
01634 
01635   // The following is a primitive parser for a mailbox-list (cf. RFC 2822).
01636   // The purpose is to extract a displayable string from the mailboxes.
01637   // Comments in the addr-spec are not handled. No error checking is done.
01638 
01639   enum { TopLevel, InComment, InAngleAddress } context = TopLevel;
01640   bool inQuotedString = false;
01641   int commentLevel = 0;
01642   bool stop = false;
01643 
01644   for ( char* p = address.data(); *p && !stop; ++p ) {
01645     switch ( context ) {
01646     case TopLevel : {
01647       switch ( *p ) {
01648       case '"' : inQuotedString = !inQuotedString;
01649                  displayName += *p;
01650                  break;
01651       case '(' : if ( !inQuotedString ) {
01652                    context = InComment;
01653                    commentLevel = 1;
01654                  }
01655                  else
01656                    displayName += *p;
01657                  break;
01658       case '<' : if ( !inQuotedString ) {
01659                    context = InAngleAddress;
01660                  }
01661                  else
01662                    displayName += *p;
01663                  break;
01664       case '\\' : // quoted character
01665                  displayName += *p;
01666                  ++p; // skip the '\'
01667                  if ( *p )
01668                    displayName += *p;
01669                  else
01670                    //return KPIM::UnexpectedEnd;
01671                    goto ABORT_PARSING;
01672                  break;
01673       case ',' : if ( !inQuotedString ) {
01674                    //if ( allowMultipleAddresses )
01675                    //  stop = true;
01676                    //else
01677                    //  return KPIM::UnexpectedComma;
01678                    goto ABORT_PARSING;
01679                  }
01680                  else
01681                    displayName += *p;
01682                  break;
01683       default :  displayName += *p;
01684       }
01685       break;
01686     }
01687     case InComment : {
01688       switch ( *p ) {
01689       case '(' : ++commentLevel;
01690                  comment += *p;
01691                  break;
01692       case ')' : --commentLevel;
01693                  if ( commentLevel == 0 ) {
01694                    context = TopLevel;
01695                    comment += ' '; // separate the text of several comments
01696                  }
01697                  else
01698                    comment += *p;
01699                  break;
01700       case '\\' : // quoted character
01701                  comment += *p;
01702                  ++p; // skip the '\'
01703                  if ( *p )
01704                    comment += *p;
01705                  else
01706                    //return KPIM::UnexpectedEnd;
01707                    goto ABORT_PARSING;
01708                  break;
01709       default :  comment += *p;
01710       }
01711       break;
01712     }
01713     case InAngleAddress : {
01714       switch ( *p ) {
01715       case '"' : inQuotedString = !inQuotedString;
01716                  addrSpec += *p;
01717                  break;
01718       case '>' : if ( !inQuotedString ) {
01719                    context = TopLevel;
01720                  }
01721                  else
01722                    addrSpec += *p;
01723                  break;
01724       case '\\' : // quoted character
01725                  addrSpec += *p;
01726                  ++p; // skip the '\'
01727                  if ( *p )
01728                    addrSpec += *p;
01729                  else
01730                    //return KPIM::UnexpectedEnd;
01731                    goto ABORT_PARSING;
01732                  break;
01733       default :  addrSpec += *p;
01734       }
01735       break;
01736     }
01737     } // switch ( context )
01738   }
01739 
01740 ABORT_PARSING:
01741   displayName = displayName.stripWhiteSpace();
01742   comment = comment.stripWhiteSpace();
01743   addrSpec = addrSpec.stripWhiteSpace();
01744 
01745   fullName = QString::fromUtf8( displayName );
01746   email = QString::fromUtf8( addrSpec );
01747 
01748   // check for errors
01749   if ( inQuotedString )
01750     return; // KPIM::UnbalancedQuote;
01751   if ( context == InComment )
01752     return; // KPIM::UnbalancedParens;
01753   if ( context == InAngleAddress )
01754     return; // KPIM::UnclosedAngleAddr;
01755 
01756   if ( addrSpec.isEmpty() ) {
01757     if ( displayName.isEmpty() )
01758       return; // KPIM::NoAddressSpec;
01759     else {
01760       //addrSpec = displayName;
01761       //displayName.truncate( 0 );
01762       // Address of the form "foo@bar" or "foo@bar (Name)".
01763       email = fullName;
01764       fullName = QString::fromUtf8( comment );
01765     }
01766   }
01767 
01768   // Check that we do not have any extra characters on the end of the
01769   // strings
01770   unsigned int len = fullName.length();
01771   if ( fullName[ 0 ] == '"' && fullName[ len - 1 ] == '"' )
01772     fullName = fullName.mid( 1, len - 2 );
01773 }
01774 
01775 void Addressee::setResource( Resource *resource )
01776 {
01777   detach();
01778   mData->resource = resource;
01779 }
01780 
01781 Resource *Addressee::resource() const
01782 {
01783   return mData->resource;
01784 }
01785 
01786 void Addressee::setChanged( bool value )
01787 {
01788   detach();
01789   mData->changed = value;
01790 }
01791 
01792 bool Addressee::changed() const
01793 {
01794   return mData->changed;
01795 }
01796 
01797 void Addressee::setSortMode( KABC::SortMode *mode )
01798 {
01799   mSortMode = mode;
01800 }
01801 
01802 bool Addressee::operator< ( const Addressee &addr )
01803 {
01804   if ( !mSortMode )
01805     return false;
01806   else
01807     return mSortMode->lesser( *this, addr );
01808 }
01809 
01810 QDataStream &KABC::operator<<( QDataStream &s, const Addressee &a )
01811 {
01812   if (!a.mData) return s;
01813 
01814   s << a.uid();
01815 
01816   s << a.mData->name;
01817   s << a.mData->formattedName;
01818   s << a.mData->familyName;
01819   s << a.mData->givenName;
01820   s << a.mData->additionalName;
01821   s << a.mData->prefix;
01822   s << a.mData->suffix;
01823   s << a.mData->nickName;
01824   s << a.mData->birthday;
01825   s << a.mData->mailer;
01826   s << a.mData->timeZone;
01827   s << a.mData->geo;
01828   s << a.mData->title;
01829   s << a.mData->role;
01830   s << a.mData->organization;
01831   s << a.mData->department;
01832   s << a.mData->note;
01833   s << a.mData->productId;
01834   s << a.mData->revision;
01835   s << a.mData->sortString;
01836   s << a.mData->url;
01837   s << a.mData->secrecy;
01838   s << a.mData->logo;
01839   s << a.mData->photo;
01840   s << a.mData->sound;
01841   s << a.mData->agent;
01842   s << a.mData->phoneNumbers;
01843   s << a.mData->addresses;
01844   s << a.mData->emails;
01845   s << a.mData->categories;
01846   s << a.mData->custom;
01847   s << a.mData->keys;
01848   return s;
01849 }
01850 
01851 QDataStream &KABC::operator>>( QDataStream &s, Addressee &a )
01852 {
01853   if (!a.mData)
01854     return s;
01855 
01856   a.detach();
01857 
01858   s >> a.mData->uid;
01859 
01860   s >> a.mData->name;
01861   s >> a.mData->formattedName;
01862   s >> a.mData->familyName;
01863   s >> a.mData->givenName;
01864   s >> a.mData->additionalName;
01865   s >> a.mData->prefix;
01866   s >> a.mData->suffix;
01867   s >> a.mData->nickName;
01868   s >> a.mData->birthday;
01869   s >> a.mData->mailer;
01870   s >> a.mData->timeZone;
01871   s >> a.mData->geo;
01872   s >> a.mData->title;
01873   s >> a.mData->role;
01874   s >> a.mData->organization;
01875   s >> a.mData->department;
01876   s >> a.mData->note;
01877   s >> a.mData->productId;
01878   s >> a.mData->revision;
01879   s >> a.mData->sortString;
01880   s >> a.mData->url;
01881   s >> a.mData->secrecy;
01882   s >> a.mData->logo;
01883   s >> a.mData->photo;
01884   s >> a.mData->sound;
01885   s >> a.mData->agent;
01886   s >> a.mData->phoneNumbers;
01887   s >> a.mData->addresses;
01888   s >> a.mData->emails;
01889   s >> a.mData->categories;
01890   s >> a.mData->custom;
01891   s >> a.mData->keys;
01892 
01893   a.mData->empty = false;
01894 
01895   return s;
01896 }
01897 
01898 bool matchBinaryPattern( int value, int pattern )
01899 {
01906   if ( pattern == 0 )
01907     return ( value == 0 );
01908   else
01909     return ( pattern == ( pattern & value ) );
01910 }
01911 
01912 template <class L>
01913 bool listEquals( const QValueList<L> &list, const QValueList<L> &pattern )
01914 {
01915   if ( list.count() != pattern.count() )
01916     return false;
01917 
01918   for ( uint i = 0; i < list.count(); ++i )
01919     if ( pattern.find( list[ i ] ) == pattern.end() )
01920       return false;
01921 
01922   return true;
01923 }
01924 
01925 bool emailsEquals( const QStringList &list, const QStringList &pattern )
01926 {
01927   if ( list.count() != pattern.count() )
01928     return false;
01929 
01930   if ( list.first() != pattern.first() )
01931     return false;
01932 
01933   QStringList::ConstIterator it;
01934   for ( it = list.begin(); it != list.end(); ++it )
01935     if ( pattern.find( *it ) == pattern.end() )
01936       return false;
01937 
01938   return true;
01939 }
KDE Home | KDE Accessibility Home | Description of Access Keys