1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
|
/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser General Public
** License version 2.1 as published by the Free Software Foundation and
** appearing in the file LICENSE.LGPL included in the packaging of this
** file. Please review the following information to ensure the GNU Lesser
** General Public License version 2.1 requirements will be met:
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU General
** Public License version 3.0 as published by the Free Software Foundation
** and appearing in the file LICENSE.GPL included in the packaging of this
** file. Please review the following information to ensure the GNU General
** Public License version 3.0 requirements will be met:
** http://www.gnu.org/copyleft/gpl.html.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms and
** conditions contained in a signed written agreement between you and Nokia.
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qcontactid.h"
#include "qcontactid_p.h"
#include <QHash>
#include <QDebug>
#include <QDataStream>
QTM_BEGIN_NAMESPACE
/*!
\class QContactId
\inmodule QtContacts
\brief The QContactId class provides information that uniquely identifies
a contact in a particular manager.
\since 1.0
It consists of a manager URI which identifies the manager which contains the contact,
and the local id of the contact in that manager.
A "null" QContactId has an empty manager URI, and an invalid QContactLocalId (0).
\sa QContactLocalId
*/
/*!
\typedef QContactLocalId
\relates QContactId
\brief The QContactLocalId type represents the unique id of a contact within its manager.
Most operations within a \l QContactManager accept a QContactLocalId. Some operations
(involving links to contacts outside a particular manager) also accept a manager URI - this
combination is stored in a \l QContactId.
An invalid QContactLocalId is represented by a zero (0) value.
\sa QContactId
*/
/*!
* Constructs a new contact id
*/
QContactId::QContactId()
: d(new QContactIdPrivate)
{
}
/*!
* Cleans up the memory in use by the contact id
*/
QContactId::~QContactId()
{
}
/*! Constructs a new contact id as a copy of \a other */
QContactId::QContactId(const QContactId& other)
: d(other.d)
{
}
/*! Assigns the contact id to be equal to \a other
\since 1.0
*/
QContactId& QContactId::operator=(const QContactId& other)
{
d = other.d;
return *this;
}
/*! Returns true if the contact id has the same manager URI and local id as \a other
\since 1.0
*/
bool QContactId::operator==(const QContactId& other) const
{
if (d->m_managerUri != other.d->m_managerUri)
return false;
if (d->m_localId != other.d->m_localId)
return false;
return true;
}
/*! Returns true if either the manager URI or local id of the contact id is different to that of \a other
\since 1.0
*/
bool QContactId::operator!=(const QContactId& other) const
{
return !(*this == other);
}
/*! Returns true if this id is less than the \a other id.
This id will be considered less than the \a other id if the
manager URI of this id is alphabetically less than the manager
URI of the \a other id. If both ids have the same manager URI,
this id will be considered less than the \a other id if the
local id of this id is less than the local id of the \a other id.
The invalid, empty id consists of an empty manager URI and the
invalid, zero local id, and hence will be less than any non-invalid
id.
This operator is provided primarily to allow use of a QContactId
as a key in a QMap.
\since 1.0
*/
bool QContactId::operator<(const QContactId& other) const
{
const int comp = this->managerUri().compare(other.managerUri());
if (comp != 0)
return comp < 0;
return this->localId() < other.localId();
}
/*!
* Returns the hash value for \a key.
* \since 1.0
*/
uint qHash(const QContactId &key)
{
return QT_PREPEND_NAMESPACE(qHash)(key.managerUri())
+ QT_PREPEND_NAMESPACE(qHash)(key.localId());
}
#ifndef QT_NO_DEBUG_STREAM
QDebug operator<<(QDebug dbg, const QContactId& id)
{
dbg.nospace() << "QContactId(" << id.managerUri() << ", " << id.localId() << ")";
return dbg.maybeSpace();
}
#endif
#ifndef QT_NO_DATASTREAM
QDataStream& operator<<(QDataStream& out, const QContactId& id)
{
quint8 formatVersion = 1; // Version of QDataStream format for QContactId
return out << formatVersion << id.managerUri() << id.localId();
}
QDataStream& operator>>(QDataStream& in, QContactId& id)
{
id = QContactId();
quint8 formatVersion;
in >> formatVersion;
if (formatVersion == 1) {
QString managerUri;
QContactLocalId localId;
in >> managerUri >> localId;
id.setManagerUri(managerUri);
id.setLocalId(localId);
} else {
in.setStatus(QDataStream::ReadCorruptData);
}
return in;
}
#endif
/*!
* Returns the URI of the manager which contains the contact identified by this id
* \since 1.0
*/
QString QContactId::managerUri() const
{
return d->m_managerUri;
}
/*!
* Returns the manager-local id of the contact identified by this contact id
* \since 1.0
*/
QContactLocalId QContactId::localId() const
{
return d->m_localId;
}
/*!
* Sets the URI of the manager which contains the contact identified by this id to \a uri
* \since 1.0
*/
void QContactId::setManagerUri(const QString& uri)
{
d->m_managerUri = uri;
}
/*!
* Sets the manager-local id of the contact identified by this contact id to \a id
* \since 1.0
*/
void QContactId::setLocalId(const QContactLocalId& id)
{
d->m_localId = id;
}
QTM_END_NAMESPACE
|
