person.h

Go to the documentation of this file.

/*
  This file is part of the kcal library.

  Copyright (c) 2001-2003 Cornelius Schumacher <schumacher@kde.org>
  Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Library General Public
  License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Library General Public License for more details.

  You should have received a copy of the GNU Library General Public License
  along with this library; see the file COPYING.LIB.  If not, write to
  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  Boston, MA 02110-1301, USA.
*/
#ifndef KCAL_PERSON_H
#define KCAL_PERSON_H

#include <QtCore/QString>
#include <QtCore/QHash>

#include "kcal_export.h"

namespace KCal {

class KCAL_DEPRECATED_EXPORT Person
{
  public:
    Person();

    static Person fromFullName( const QString &fullName );

    KCAL_DEPRECATED explicit Person( const QString &fullName );

    Person( const QString &name, const QString &email );

    Person( const Person &person );

    ~Person();

    bool isEmpty() const;

    QString fullName( ) const;

    void setName( const QString &name );

    QString name() const;

    void setEmail( const QString &email );

    QString email() const;

    //KDE5: make const for all
#if defined(Q_CC_MSVC)
    bool operator==( const Person &person ) const;
#else
    bool operator==( const Person &person ); //krazy:exclude=operators
#endif

    Person &operator=( const Person &person );

  private:
    //@cond PRIVATE
    class Private;
    Private *const d;
   //@endcond
};

}

/*
  Return a hash value for a Person argument.
  @param key is a Person.
  @since 4.4
*/
inline uint qHash( const KCal::Person &key ) //krazy:exclude=inline
{
  return qHash( key.fullName() );
}

#endif