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
235
236
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/tools/quuid.cpp:40 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QUuid Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QUuid Class Reference</h1>
<p>The QUuid class defines a Universally Unique Identifier (UUID).
<a href="#details">More...</a>
<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when Qt is built with thread support.</p>
<p><tt>#include <<a href="quuid-h.html">quuid.h</a>></tt>
<p><a href="quuid-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn>enum <a href="#Variant-enum"><b>Variant</b></a> { VarUnknown = -1, NCS = 0, DCE = 2, Microsoft = 6, Reserved = 7 }</li>
<li class=fn>enum <a href="#Version-enum"><b>Version</b></a> { VerUnknown = -1, Time = 1, EmbeddedPOSIX = 2, Name = 3, Random = 4 }</li>
<li class=fn><a href="#QUuid"><b>QUuid</b></a> ()</li>
<li class=fn><a href="#QUuid-2"><b>QUuid</b></a> ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3, uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )</li>
<li class=fn><a href="#QUuid-3"><b>QUuid</b></a> ( const QUuid & orig )</li>
<li class=fn><a href="#QUuid-4"><b>QUuid</b></a> ( const QString & text )</li>
<li class=fn>QString <a href="#toString"><b>toString</b></a> () const</li>
<li class=fn><a href="#operator-QString"><b>operator QString</b></a> () const</li>
<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li>
<li class=fn>QUuid & <a href="#operator-eq"><b>operator=</b></a> ( const QUuid & uuid )</li>
<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QUuid & other ) const</li>
<li class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QUuid & other ) const</li>
<li class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QUuid & other ) const</li>
<li class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QUuid & other ) const</li>
<li class=fn>QUuid::Variant <a href="#variant"><b>variant</b></a> () const</li>
<li class=fn>QUuid::Version <a href="#version"><b>version</b></a> () const</li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li class=fn>QUuid <a href="#createUuid"><b>createUuid</b></a> ()</li>
</ul>
<h2>Related Functions</h2>
<ul>
<li class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QUuid & id )</li>
<li class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QUuid & id )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QUuid class defines a Universally Unique Identifier (UUID).
<p>
<p> For objects or declarations that must be uniquely identified,
UUIDs (also known as GUIDs) are widely used in order to assign a
fixed and easy to compare value to the object or declaration. The
128-bit value of a UUID is generated by an algorithm that
guarantees that the value is unique.
<p> In Qt, UUIDs are wrapped by the QUuid struct which provides
convenience functions for handling UUIDs. Most platforms provide a
tool to generate new UUIDs, for example, uuidgen and guidgen.
<p> UUIDs generated by QUuid, are based on the <a href="#Version-enum">Random</a> version of the
<a href="#Variant-enum">DCE</a> (Distributed Computing Environment) standard.
<p> UUIDs can be constructed from numeric values or from strings, or
using the static <a href="#createUuid">createUuid</a>() function. They can be converted to a
string with <a href="#toString">toString</a>(). UUIDs have a <a href="#variant">variant</a>() and a <a href="#version">version</a>(),
and null UUIDs return TRUE from <a href="#isNull">isNull</a>().
<hr><h2>Member Type Documentation</h2>
<h3 class=fn><a name="Variant-enum"></a>QUuid::Variant</h3>
<p> This enum defines the variant of the UUID, which is the scheme
which defines the layout of the 128-bits value.
<ul>
<li><tt>QUuid::VarUnknown</tt> - Variant is unknown
<li><tt>QUuid::NCS</tt> - Reserved for NCS (Network Computing System) backward compatibility
<li><tt>QUuid::DCE</tt> - Distributed Computing Environment, the scheme used by QUuid
<li><tt>QUuid::Microsoft</tt> - Reserved for Microsoft backward compatibility (GUID)
<li><tt>QUuid::Reserved</tt> - Reserved for future definition
</ul>
<h3 class=fn><a name="Version-enum"></a>QUuid::Version</h3>
<p> This enum defines the version of the UUID.
<ul>
<li><tt>QUuid::VerUnknown</tt> - Version is unknown
<li><tt>QUuid::Time</tt> - Time-based, by using timestamp, clock sequence, and
MAC network card address (if available) for the node sections
<li><tt>QUuid::EmbeddedPOSIX</tt> - DCE Security version, with embedded POSIX UUIDs
<li><tt>QUuid::Name</tt> - Name-based, by using values from a name for all sections
<li><tt>QUuid::Random</tt> - Random-based, by using random numbers for all sections
</ul>
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QUuid"></a>QUuid::QUuid ()
</h3>
<p> Creates the null UUID {00000000-0000-0000-0000-000000000000}.
<h3 class=fn><a name="QUuid-2"></a>QUuid::QUuid ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3, uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )
</h3>
<p> Creates a UUID with the value specified by the parameters, <em>l</em>,
<em>w1</em>, <em>w2</em>, <em>b1</em>, <em>b2</em>, <em>b3</em>, <em>b4</em>, <em>b5</em>, <em>b6</em>, <em>b7</em>, <em>b8</em>.
<p> Example:
<pre>
// {67C8770B-44F1-410A-AB9A-F9B5446F13EE}
QUuid IID_MyInterface( 0x67c8770b, 0x44f1, 0x410a, 0xab, 0x9a, 0xf9, 0xb5, 0x44, 0x6f, 0x13, 0xee )
</pre>
<h3 class=fn><a name="QUuid-3"></a>QUuid::QUuid ( const <a href="quuid.html">QUuid</a> & orig )
</h3>
<p> Creates a copy of the QUuid <em>orig</em>.
<h3 class=fn><a name="QUuid-4"></a>QUuid::QUuid ( const <a href="qstring.html">QString</a> & text )
</h3>
Creates a QUuid object from the string <em>text</em>. The function can
only convert a string in the format
{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} (where 'H' stands for a hex
digit). If the conversion fails a null UUID is created.
<h3 class=fn><a href="quuid.html">QUuid</a> <a name="createUuid"></a>QUuid::createUuid ()<tt> [static]</tt>
</h3>
<p> Returns a new UUID of <a href="#Variant-enum">DCE</a> variant, and <a href="#Version-enum">Random</a> type. The
UUIDs generated are based on the platform specific pseudo-random
generator, which is usually not a cryptographic-quality random
number generator. Therefore, a UUID is not guaranteed to be unique
cross application instances.
<p> On Windows, the new UUID is extremely likely to be unique on the
same or any other system, networked or not.
<p> <p>See also <a href="#variant">variant</a>() and <a href="#version">version</a>().
<h3 class=fn>bool <a name="isNull"></a>QUuid::isNull () const
</h3>
Returns TRUE if this is the null UUID
{00000000-0000-0000-0000-000000000000}; otherwise returns FALSE.
<h3 class=fn><a name="operator-QString"></a>QUuid::operator QString () const
</h3>
<p> Returns the string representation of the uuid.
<p> <p>See also <a href="#toString">toString</a>().
<h3 class=fn>bool <a name="operator!-eq"></a>QUuid::operator!= ( const <a href="quuid.html">QUuid</a> & other ) const
</h3>
<p> Returns TRUE if this QUuid and the <em>other</em> QUuid are different;
otherwise returns FALSE.
<h3 class=fn>bool <a name="operator-lt"></a>QUuid::operator< ( const <a href="quuid.html">QUuid</a> & other ) const
</h3>
<p> Returns TRUE if this QUuid is of the same variant,
and lexicographically before the <em>other</em> QUuid;
otherwise returns FALSE.
<p> <p>See also <a href="#variant">variant</a>().
<h3 class=fn><a href="quuid.html">QUuid</a> & <a name="operator-eq"></a>QUuid::operator= ( const <a href="quuid.html">QUuid</a> & uuid )
</h3>
<p> Assigns the value of <em>uuid</em> to this QUuid object.
<h3 class=fn>bool <a name="operator-eq-eq"></a>QUuid::operator== ( const <a href="quuid.html">QUuid</a> & other ) const
</h3>
<p> Returns TRUE if this QUuid and the <em>other</em> QUuid are identical;
otherwise returns FALSE.
<h3 class=fn>bool <a name="operator-gt"></a>QUuid::operator> ( const <a href="quuid.html">QUuid</a> & other ) const
</h3>
<p> Returns TRUE if this QUuid is of the same variant,
and lexicographically after the <em>other</em> QUuid;
otherwise returns FALSE.
<p> <p>See also <a href="#variant">variant</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="toString"></a>QUuid::toString () const
</h3>
<a href="qstring.html">QString</a> <a href="#toString">QUuid::toString</a>() const
<p> Returns the string representation of the uuid.
<h3 class=fn><a href="quuid.html#Variant-enum">QUuid::Variant</a> <a name="variant"></a>QUuid::variant () const
</h3>
<p> Returns the variant of the UUID.
The null UUID is considered to be of an unknown variant.
<p> <p>See also <a href="#version">version</a>().
<h3 class=fn><a href="quuid.html#Version-enum">QUuid::Version</a> <a name="version"></a>QUuid::version () const
</h3>
<p> Returns the version of the UUID, if the UUID is of the DCE
variant; otherwise returns VerUnknown.
<p> <p>See also <a href="#variant">variant</a>().
<hr><h2>Related Functions</h2>
<h3 class=fn><a href="qdatastream.html">QDataStream</a> & <a name="operator-lt-lt"></a>operator<< ( <a href="qdatastream.html">QDataStream</a> & s, const <a href="quuid.html">QUuid</a> & id )
</h3>
Writes the uuid <em>id</em> to the datastream <em>s</em>.
<h3 class=fn><a href="qdatastream.html">QDataStream</a> & <a name="operator-gt-gt"></a>operator>> ( <a href="qdatastream.html">QDataStream</a> & s, <a href="quuid.html">QUuid</a> & id )
</h3>
Reads uuid from from the stream <em>s</em> into <em>id</em>.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>
|
