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       text = "\"" + realName() + "\" <" + e + ">";
01140     else
01141       text = realName() + " <" + e + ">";
01142   }
01143 
01144   return text;
01145 }
01146 
01147 void Addressee::insertEmail( const QString &email, bool preferred )
01148 {
01149   if ( email.simplifyWhiteSpace().isEmpty() )
01150     return;
01151 
01152   detach();
01153   mData->empty = false;
01154 
01155   QStringList::Iterator it = mData->emails.find( email );
01156 
01157   if ( it != mData->emails.end() ) {
01158     if ( !preferred || it == mData->emails.begin() ) return;
01159     mData->emails.remove( it );
01160     mData->emails.prepend( email );
01161   } else {
01162     if ( preferred ) {
01163       mData->emails.prepend( email );
01164     } else {
01165       mData->emails.append( email );
01166     }
01167   }
01168 }
01169 
01170 void Addressee::removeEmail( const QString &email )
01171 {
01172   detach();
01173 
01174   QStringList::Iterator it = mData->emails.find( email );
01175   if ( it == mData->emails.end() ) return;
01176 
01177   mData->emails.remove( it );
01178 }
01179 
01180 QString Addressee::preferredEmail() const
01181 {
01182   if ( mData->emails.count() == 0 ) return QString::null;
01183   else return mData->emails.first();
01184 }
01185 
01186 QStringList Addressee::emails() const
01187 {
01188   return mData->emails;
01189 }
01190 void Addressee::setEmails( const QStringList& emails ) {
01191   detach();
01192 
01193   mData->emails = emails;
01194 }
01195 void Addressee::insertPhoneNumber( const PhoneNumber &phoneNumber )
01196 {
01197   detach();
01198   mData->empty = false;
01199 
01200   PhoneNumber::List::Iterator it;
01201   for( it = mData->phoneNumbers.begin(); it != mData->phoneNumbers.end(); ++it ) {
01202     if ( (*it).id() == phoneNumber.id() ) {
01203       *it = phoneNumber;
01204       return;
01205     }
01206   }
01207   if ( !phoneNumber.number().simplifyWhiteSpace().isEmpty() )
01208     mData->phoneNumbers.append( phoneNumber );
01209 }
01210 
01211 void Addressee::removePhoneNumber( const PhoneNumber &phoneNumber )
01212 {
01213   detach();
01214 
01215   PhoneNumber::List::Iterator it;
01216   for( it = mData->phoneNumbers.begin(); it != mData->phoneNumbers.end(); ++it ) {
01217     if ( (*it).id() == phoneNumber.id() ) {
01218       mData->phoneNumbers.remove( it );
01219       return;
01220     }
01221   }
01222 }
01223 
01224 PhoneNumber Addressee::phoneNumber( int type ) const
01225 {
01226   PhoneNumber phoneNumber( "", type );
01227   PhoneNumber::List::ConstIterator it;
01228   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01229     if ( matchBinaryPattern( (*it).type(), type ) ) {
01230       if ( (*it).type() & PhoneNumber::Pref )
01231         return (*it);
01232       else if ( phoneNumber.number().isEmpty() )
01233         phoneNumber = (*it);
01234     }
01235   }
01236 
01237   return phoneNumber;
01238 }
01239 
01240 PhoneNumber::List Addressee::phoneNumbers() const
01241 {
01242   return mData->phoneNumbers;
01243 }
01244 
01245 PhoneNumber::List Addressee::phoneNumbers( int type ) const
01246 {
01247   PhoneNumber::List list;
01248 
01249   PhoneNumber::List::ConstIterator it;
01250   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01251     if ( matchBinaryPattern( (*it).type(), type ) ) {
01252       list.append( *it );
01253     }
01254   }
01255   return list;
01256 }
01257 
01258 PhoneNumber Addressee::findPhoneNumber( const QString &id ) const
01259 {
01260   PhoneNumber::List::ConstIterator it;
01261   for( it = mData->phoneNumbers.constBegin(); it != mData->phoneNumbers.constEnd(); ++it ) {
01262     if ( (*it).id() == id ) {
01263       return *it;
01264     }
01265   }
01266   return PhoneNumber();
01267 }
01268 
01269 void Addressee::insertKey( const Key &key )
01270 {
01271   detach();
01272   mData->empty = false;
01273 
01274   Key::List::Iterator it;
01275   for( it = mData->keys.begin(); it != mData->keys.end(); ++it ) {
01276     if ( (*it).id() == key.id() ) {
01277       *it = key;
01278       return;
01279     }
01280   }
01281   mData->keys.append( key );
01282 }
01283 
01284 void Addressee::removeKey( const Key &key )
01285 {
01286   detach();
01287 
01288   Key::List::Iterator it;
01289   for( it = mData->keys.begin(); it != mData->keys.end(); ++it ) {
01290     if ( (*it).id() == key.id() ) {
01291       mData->keys.remove( key );
01292       return;
01293     }
01294   }
01295 }
01296 
01297 Key Addressee::key( int type, QString customTypeString ) const
01298 {
01299   Key::List::ConstIterator it;
01300   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01301     if ( (*it).type() == type ) {
01302       if ( type == Key::Custom ) {
01303         if ( customTypeString.isEmpty() ) {
01304           return *it;
01305         } else {
01306           if ( (*it).customTypeString() == customTypeString )
01307             return (*it);
01308         }
01309       } else {
01310         return *it;
01311       }
01312     }
01313   }
01314   return Key( QString(), type );
01315 }
01316 
01317 void Addressee::setKeys( const Key::List& list )
01318 {
01319   detach();
01320   mData->keys = list;
01321 }
01322 
01323 Key::List Addressee::keys() const
01324 {
01325   return mData->keys;
01326 }
01327 
01328 Key::List Addressee::keys( int type, QString customTypeString ) const
01329 {
01330   Key::List list;
01331 
01332   Key::List::ConstIterator it;
01333   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01334     if ( (*it).type() == type ) {
01335       if ( type == Key::Custom ) {
01336         if ( customTypeString.isEmpty() ) {
01337           list.append( *it );
01338         } else {
01339           if ( (*it).customTypeString() == customTypeString )
01340             list.append( *it );
01341         }
01342       } else {
01343         list.append( *it );
01344       }
01345     }
01346   }
01347   return list;
01348 }
01349 
01350 Key Addressee::findKey( const QString &id ) const
01351 {
01352   Key::List::ConstIterator it;
01353   for( it = mData->keys.constBegin(); it != mData->keys.constEnd(); ++it ) {
01354     if ( (*it).id() == id ) {
01355       return *it;
01356     }
01357   }
01358   return Key();
01359 }
01360 
01361 QString Addressee::asString() const
01362 {
01363   return "Smith, agent Smith...";
01364 }
01365 
01366 void Addressee::dump() const
01367 {
01368   kdDebug(5700) << "Addressee {" << endl;
01369 
01370   kdDebug(5700) << "  Uid: '" << uid() << "'" << endl;
01371 
01372   kdDebug(5700) << "  Name: '" << name() << "'" << endl;
01373   kdDebug(5700) << "  FormattedName: '" << formattedName() << "'" << endl;
01374   kdDebug(5700) << "  FamilyName: '" << familyName() << "'" << endl;
01375   kdDebug(5700) << "  GivenName: '" << givenName() << "'" << endl;
01376   kdDebug(5700) << "  AdditionalName: '" << additionalName() << "'" << endl;
01377   kdDebug(5700) << "  Prefix: '" << prefix() << "'" << endl;
01378   kdDebug(5700) << "  Suffix: '" << suffix() << "'" << endl;
01379   kdDebug(5700) << "  NickName: '" << nickName() << "'" << endl;
01380   kdDebug(5700) << "  Birthday: '" << birthday().toString() << "'" << endl;
01381   kdDebug(5700) << "  Mailer: '" << mailer() << "'" << endl;
01382   kdDebug(5700) << "  TimeZone: '" << timeZone().asString() << "'" << endl;
01383   kdDebug(5700) << "  Geo: '" << geo().asString() << "'" << endl;
01384   kdDebug(5700) << "  Title: '" << title() << "'" << endl;
01385   kdDebug(5700) << "  Role: '" << role() << "'" << endl;
01386   kdDebug(5700) << "  Organization: '" << organization() << "'" << endl;
01387   kdDebug(5700) << "  Department: '" << department() << "'" << endl;
01388   kdDebug(5700) << "  Note: '" << note() << "'" << endl;
01389   kdDebug(5700) << "  ProductId: '" << productId() << "'" << endl;
01390   kdDebug(5700) << "  Revision: '" << revision().toString() << "'" << endl;
01391   kdDebug(5700) << "  SortString: '" << sortString() << "'" << endl;
01392   kdDebug(5700) << "  Url: '" << url().url() << "'" << endl;
01393   kdDebug(5700) << "  Secrecy: '" << secrecy().asString() << "'" << endl;
01394   kdDebug(5700) << "  Logo: '" << logo().asString() << "'" << endl;
01395   kdDebug(5700) << "  Photo: '" << photo().asString() << "'" << endl;
01396   kdDebug(5700) << "  Sound: '" << sound().asString() << "'" << endl;
01397   kdDebug(5700) << "  Agent: '" << agent().asString() << "'" << endl;
01398 
01399   kdDebug(5700) << "  Emails {" << endl;
01400   const QStringList e = emails();
01401   QStringList::ConstIterator it;
01402   for( it = e.begin(); it != e.end(); ++it ) {
01403     kdDebug(5700) << "    " << (*it) << endl;
01404   }
01405   kdDebug(5700) << "  }" << endl;
01406 
01407   kdDebug(5700) << "  PhoneNumbers {" << endl;
01408   const PhoneNumber::List p = phoneNumbers();
01409   PhoneNumber::List::ConstIterator it2;
01410   for( it2 = p.begin(); it2 != p.end(); ++it2 ) {
01411     kdDebug(5700) << "    Type: " << int((*it2).type()) << " Number: " << (*it2).number() << endl;
01412   }
01413   kdDebug(5700) << "  }" << endl;
01414 
01415   const Address::List a = addresses();
01416   Address::List::ConstIterator it3;
01417   for( it3 = a.begin(); it3 != a.end(); ++it3 ) {
01418     (*it3).dump();
01419   }
01420 
01421   kdDebug(5700) << "  Keys {" << endl;
01422   const Key::List k = keys();
01423   Key::List::ConstIterator it4;
01424   for( it4 = k.begin(); it4 != k.end(); ++it4 ) {
01425     kdDebug(5700) << "    Type: " << int((*it4).type()) <<
01426                      " Key: " << (*it4).textData() <<
01427                      " CustomString: " << (*it4).customTypeString() << endl;
01428   }
01429   kdDebug(5700) << "  }" << endl;
01430 
01431   kdDebug(5700) << "}" << endl;
01432 }
01433 
01434 
01435 void Addressee::insertAddress( const Address &address )
01436 {
01437   if ( address.isEmpty() )
01438     return;
01439 
01440   detach();
01441   mData->empty = false;
01442 
01443   Address::List::Iterator it;
01444   for( it = mData->addresses.begin(); it != mData->addresses.end(); ++it ) {
01445     if ( (*it).id() == address.id() ) {
01446       *it = address;
01447       return;
01448     }
01449   }
01450 
01451   mData->addresses.append( address );
01452 }
01453 
01454 void Addressee::removeAddress( const Address &address )
01455 {
01456   detach();
01457 
01458   Address::List::Iterator it;
01459   for( it = mData->addresses.begin(); it != mData->addresses.end(); ++it ) {
01460     if ( (*it).id() == address.id() ) {
01461       mData->addresses.remove( it );
01462       return;
01463     }
01464   }
01465 }
01466 
01467 Address Addressee::address( int type ) const
01468 {
01469   Address address( type );
01470   Address::List::ConstIterator it;
01471   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01472     if ( matchBinaryPattern( (*it).type(), type ) ) {
01473       if ( (*it).type() & Address::Pref )
01474         return (*it);
01475       else if ( address.isEmpty() )
01476         address = (*it);
01477     }
01478   }
01479 
01480   return address;
01481 }
01482 
01483 Address::List Addressee::addresses() const
01484 {
01485   return mData->addresses;
01486 }
01487 
01488 Address::List Addressee::addresses( int type ) const
01489 {
01490   Address::List list;
01491 
01492   Address::List::ConstIterator it;
01493   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01494     if ( matchBinaryPattern( (*it).type(), type ) ) {
01495       list.append( *it );
01496     }
01497   }
01498 
01499   return list;
01500 }
01501 
01502 Address Addressee::findAddress( const QString &id ) const
01503 {
01504   Address::List::ConstIterator it;
01505   for( it = mData->addresses.constBegin(); it != mData->addresses.constEnd(); ++it ) {
01506     if ( (*it).id() == id ) {
01507       return *it;
01508     }
01509   }
01510   return Address();
01511 }
01512 
01513 void Addressee::insertCategory( const QString &c )
01514 {
01515   detach();
01516   mData->empty = false;
01517 
01518   if ( mData->categories.findIndex( c ) != -1 ) return;
01519 
01520   mData->categories.append( c );
01521 }
01522 
01523 void Addressee::removeCategory( const QString &c )
01524 {
01525   detach();
01526 
01527   QStringList::Iterator it = mData->categories.find( c );
01528   if ( it == mData->categories.end() ) return;
01529 
01530   mData->categories.remove( it );
01531 }
01532 
01533 bool Addressee::hasCategory( const QString &c ) const
01534 {
01535   return ( mData->categories.findIndex( c ) != -1 );
01536 }
01537 
01538 void Addressee::setCategories( const QStringList &c )
01539 {
01540   detach();
01541   mData->empty = false;
01542 
01543   mData->categories = c;
01544 }
01545 
01546 QStringList Addressee::categories() const
01547 {
01548   return mData->categories;
01549 }
01550 
01551 void Addressee::insertCustom( const QString &app, const QString &name,
01552                               const QString &value )
01553 {
01554   if ( value.isEmpty() || name.isEmpty() || app.isEmpty() ) return;
01555 
01556   detach();
01557   mData->empty = false;
01558 
01559   QString qualifiedName = app + "-" + name + ":";
01560 
01561   QStringList::Iterator it;
01562   for( it = mData->custom.begin(); it != mData->custom.end(); ++it ) {
01563     if ( (*it).startsWith( qualifiedName ) ) {
01564       (*it) = qualifiedName + value;
01565       return;
01566     }
01567   }
01568 
01569   mData->custom.append( qualifiedName + value );
01570 }
01571 
01572 void Addressee::removeCustom( const QString &app, const QString &name)
01573 {
01574   detach();
01575 
01576   QString qualifiedName = app + "-" + name + ":";
01577 
01578   QStringList::Iterator it;
01579   for( it = mData->custom.begin(); it != mData->custom.end(); ++it ) {
01580     if ( (*it).startsWith( qualifiedName ) ) {
01581       mData->custom.remove( it );
01582       return;
01583     }
01584   }
01585 }
01586 
01587 QString Addressee::custom( const QString &app, const QString &name ) const
01588 {
01589   QString qualifiedName = app + "-" + name + ":";
01590   QString value;
01591 
01592   QStringList::ConstIterator it;
01593   for( it = mData->custom.constBegin(); it != mData->custom.constEnd(); ++it ) {
01594     if ( (*it).startsWith( qualifiedName ) ) {
01595       value = (*it).mid( (*it).find( ":" ) + 1 );
01596       break;
01597     }
01598   }
01599 
01600   return value;
01601 }
01602 
01603 void Addressee::setCustoms( const QStringList &l )
01604 {
01605   detach();
01606   mData->empty = false;
01607 
01608   mData->custom = l;
01609 }
01610 
01611 QStringList Addressee::customs() const
01612 {
01613   return mData->custom;
01614 }
01615 
01616 void Addressee::parseEmailAddress( const QString &rawEmail, QString &fullName,
01617                                    QString &email)
01618 {
01619   // This is a simplified version of KPIM::splitAddress().
01620 
01621   fullName = "";
01622   email = "";
01623   if ( rawEmail.isEmpty() )
01624     return; // KPIM::AddressEmpty;
01625 
01626   // The code works on 8-bit strings, so convert the input to UTF-8.
01627   QCString address = rawEmail.utf8();
01628 
01629   QCString displayName;
01630   QCString addrSpec;
01631   QCString comment;
01632 
01633   // The following is a primitive parser for a mailbox-list (cf. RFC 2822).
01634   // The purpose is to extract a displayable string from the mailboxes.
01635   // Comments in the addr-spec are not handled. No error checking is done.
01636 
01637   enum { TopLevel, InComment, InAngleAddress } context = TopLevel;
01638   bool inQuotedString = false;
01639   int commentLevel = 0;
01640   bool stop = false;
01641 
01642   for ( char* p = address.data(); *p && !stop; ++p ) {
01643     switch ( context ) {
01644     case TopLevel : {
01645       switch ( *p ) {
01646       case '"' : inQuotedString = !inQuotedString;
01647                  displayName += *p;
01648                  break;
01649       case '(' : if ( !inQuotedString ) {
01650                    context = InComment;
01651                    commentLevel = 1;
01652                  }
01653                  else
01654                    displayName += *p;
01655                  break;
01656       case '<' : if ( !inQuotedString ) {
01657                    context = InAngleAddress;
01658                  }
01659                  else
01660                    displayName += *p;
01661                  break;
01662       case '\\' : // quoted character
01663                  displayName += *p;
01664                  ++p; // skip the '\'
01665                  if ( *p )
01666                    displayName += *p;
01667                  else
01668                    //return KPIM::UnexpectedEnd;
01669                    goto ABORT_PARSING;
01670                  break;
01671       case ',' : if ( !inQuotedString ) {
01672                    //if ( allowMultipleAddresses )
01673                    //  stop = true;
01674                    //else
01675                    //  return KPIM::UnexpectedComma;
01676                    goto ABORT_PARSING;
01677                  }
01678                  else
01679                    displayName += *p;
01680                  break;
01681       default :  displayName += *p;
01682       }
01683       break;
01684     }
01685     case InComment : {
01686       switch ( *p ) {
01687       case '(' : ++commentLevel;
01688                  comment += *p;
01689                  break;
01690       case ')' : --commentLevel;
01691                  if ( commentLevel == 0 ) {
01692                    context = TopLevel;
01693                    comment += ' '; // separate the text of several comments
01694                  }
01695                  else
01696                    comment += *p;
01697                  break;
01698       case '\\' : // quoted character
01699                  comment += *p;
01700                  ++p; // skip the '\'
01701                  if ( *p )
01702                    comment += *p;
01703                  else
01704                    //return KPIM::UnexpectedEnd;
01705                    goto ABORT_PARSING;
01706                  break;
01707       default :  comment += *p;
01708       }
01709       break;
01710     }
01711     case InAngleAddress : {
01712       switch ( *p ) {
01713       case '"' : inQuotedString = !inQuotedString;
01714                  addrSpec += *p;
01715                  break;
01716       case '>' : if ( !inQuotedString ) {
01717                    context = TopLevel;
01718                  }
01719                  else
01720                    addrSpec += *p;
01721                  break;
01722       case '\\' : // quoted character
01723                  addrSpec += *p;
01724                  ++p; // skip the '\'
01725                  if ( *p )
01726                    addrSpec += *p;
01727                  else
01728                    //return KPIM::UnexpectedEnd;
01729                    goto ABORT_PARSING;
01730                  break;
01731       default :  addrSpec += *p;
01732       }
01733       break;
01734     }
01735     } // switch ( context )
01736   }
01737 
01738 ABORT_PARSING:
01739   displayName = displayName.stripWhiteSpace();
01740   comment = comment.stripWhiteSpace();
01741   addrSpec = addrSpec.stripWhiteSpace();
01742 
01743   fullName = QString::fromUtf8( displayName );
01744   email = QString::fromUtf8( addrSpec );
01745 
01746   // check for errors
01747   if ( inQuotedString )
01748     return; // KPIM::UnbalancedQuote;
01749   if ( context == InComment )
01750     return; // KPIM::UnbalancedParens;
01751   if ( context == InAngleAddress )
01752     return; // KPIM::UnclosedAngleAddr;
01753 
01754   if ( addrSpec.isEmpty() ) {
01755     if ( displayName.isEmpty() )
01756       return; // KPIM::NoAddressSpec;
01757     else {
01758       //addrSpec = displayName;
01759       //displayName.truncate( 0 );
01760       // Address of the form "foo@bar" or "foo@bar (Name)".
01761       email = fullName;
01762       fullName = QString::fromUtf8( comment );
01763     }
01764   }
01765 
01766   // Check that we do not have any extra characters on the end of the
01767   // strings
01768   unsigned int len = fullName.length();
01769   if ( fullName[ 0 ] == '"' && fullName[ len - 1 ] == '"' )
01770     fullName = fullName.mid( 1, len - 2 );
01771 }
01772 
01773 void Addressee::setResource( Resource *resource )
01774 {
01775   detach();
01776   mData->resource = resource;
01777 }
01778 
01779 Resource *Addressee::resource() const
01780 {
01781   return mData->resource;
01782 }
01783 
01784 void Addressee::setChanged( bool value )
01785 {
01786   detach();
01787   mData->changed = value;
01788 }
01789 
01790 bool Addressee::changed() const
01791 {
01792   return mData->changed;
01793 }
01794 
01795 void Addressee::setSortMode( KABC::SortMode *mode )
01796 {
01797   mSortMode = mode;
01798 }
01799 
01800 bool Addressee::operator< ( const Addressee &addr )
01801 {
01802   if ( !mSortMode )
01803     return false;
01804   else
01805     return mSortMode->lesser( *this, addr );
01806 }
01807 
01808 QDataStream &KABC::operator<<( QDataStream &s, const Addressee &a )
01809 {
01810   if (!a.mData) return s;
01811 
01812   s << a.uid();
01813 
01814   s << a.mData->name;
01815   s << a.mData->formattedName;
01816   s << a.mData->familyName;
01817   s << a.mData->givenName;
01818   s << a.mData->additionalName;
01819   s << a.mData->prefix;
01820   s << a.mData->suffix;
01821   s << a.mData->nickName;
01822   s << a.mData->birthday;
01823   s << a.mData->mailer;
01824   s << a.mData->timeZone;
01825   s << a.mData->geo;
01826   s << a.mData->title;
01827   s << a.mData->role;
01828   s << a.mData->organization;
01829   s << a.mData->department;
01830   s << a.mData->note;
01831   s << a.mData->productId;
01832   s << a.mData->revision;
01833   s << a.mData->sortString;
01834   s << a.mData->url;
01835   s << a.mData->secrecy;
01836   s << a.mData->logo;
01837   s << a.mData->photo;
01838   s << a.mData->sound;
01839   s << a.mData->agent;
01840   s << a.mData->phoneNumbers;
01841   s << a.mData->addresses;
01842   s << a.mData->emails;
01843   s << a.mData->categories;
01844   s << a.mData->custom;
01845   s << a.mData->keys;
01846   return s;
01847 }
01848 
01849 QDataStream &KABC::operator>>( QDataStream &s, Addressee &a )
01850 {
01851   if (!a.mData)
01852     return s;
01853 
01854   a.detach();
01855 
01856   s >> a.mData->uid;
01857 
01858   s >> a.mData->name;
01859   s >> a.mData->formattedName;
01860   s >> a.mData->familyName;
01861   s >> a.mData->givenName;
01862   s >> a.mData->additionalName;
01863   s >> a.mData->prefix;
01864   s >> a.mData->suffix;
01865   s >> a.mData->nickName;
01866   s >> a.mData->birthday;
01867   s >> a.mData->mailer;
01868   s >> a.mData->timeZone;
01869   s >> a.mData->geo;
01870   s >> a.mData->title;
01871   s >> a.mData->role;
01872   s >> a.mData->organization;
01873   s >> a.mData->department;
01874   s >> a.mData->note;
01875   s >> a.mData->productId;
01876   s >> a.mData->revision;
01877   s >> a.mData->sortString;
01878   s >> a.mData->url;
01879   s >> a.mData->secrecy;
01880   s >> a.mData->logo;
01881   s >> a.mData->photo;
01882   s >> a.mData->sound;
01883   s >> a.mData->agent;
01884   s >> a.mData->phoneNumbers;
01885   s >> a.mData->addresses;
01886   s >> a.mData->emails;
01887   s >> a.mData->categories;
01888   s >> a.mData->custom;
01889   s >> a.mData->keys;
01890 
01891   a.mData->empty = false;
01892 
01893   return s;
01894 }
01895 
01896 bool matchBinaryPattern( int value, int pattern )
01897 {
01904   if ( pattern == 0 )
01905     return ( value == 0 );
01906   else
01907     return ( pattern == ( pattern & value ) );
01908 }
01909 
01910 template <class L>
01911 bool listEquals( const QValueList<L> &list, const QValueList<L> &pattern )
01912 {
01913   if ( list.count() != pattern.count() )
01914     return false;
01915 
01916   for ( uint i = 0; i < list.count(); ++i )
01917     if ( pattern.find( list[ i ] ) == pattern.end() )
01918       return false;
01919 
01920   return true;
01921 }
01922 
01923 bool emailsEquals( const QStringList &list, const QStringList &pattern )
01924 {
01925   if ( list.count() != pattern.count() )
01926     return false;
01927 
01928   if ( list.first() != pattern.first() )
01929     return false;
01930 
01931   QStringList::ConstIterator it;
01932   for ( it = list.begin(); it != list.end(); ++it )
01933     if ( pattern.find( *it ) == pattern.end() )
01934       return false;
01935 
01936   return true;
01937 }
KDE Home | KDE Accessibility Home | Description of Access Keys