author | eckhart.koppen@nokia.com |
Wed, 31 Mar 2010 11:06:36 +0300 | |
changeset 7 | f7bc934e204c |
parent 0 | 1918ee327afb |
permissions | -rw-r--r-- |
0 | 1 |
/**************************************************************************** |
2 |
** |
|
7
f7bc934e204c
5cabc75a39ca2f064f70b40f72ed93c74c4dc19b
eckhart.koppen@nokia.com
parents:
0
diff
changeset
|
3 |
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). |
0 | 4 |
** All rights reserved. |
5 |
** Contact: Nokia Corporation (qt-info@nokia.com) |
|
6 |
** |
|
7 |
** This file is part of the QtXmlPatterns module of the Qt Toolkit. |
|
8 |
** |
|
9 |
** $QT_BEGIN_LICENSE:LGPL$ |
|
10 |
** No Commercial Usage |
|
11 |
** This file contains pre-release code and may not be distributed. |
|
12 |
** You may use this file in accordance with the terms and conditions |
|
13 |
** contained in the Technology Preview License Agreement accompanying |
|
14 |
** this package. |
|
15 |
** |
|
16 |
** GNU Lesser General Public License Usage |
|
17 |
** Alternatively, this file may be used under the terms of the GNU Lesser |
|
18 |
** General Public License version 2.1 as published by the Free Software |
|
19 |
** Foundation and appearing in the file LICENSE.LGPL included in the |
|
20 |
** packaging of this file. Please review the following information to |
|
21 |
** ensure the GNU Lesser General Public License version 2.1 requirements |
|
22 |
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
|
23 |
** |
|
24 |
** In addition, as a special exception, Nokia gives you certain additional |
|
25 |
** rights. These rights are described in the Nokia Qt LGPL Exception |
|
26 |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
|
27 |
** |
|
28 |
** If you have questions regarding the use of this file, please contact |
|
29 |
** Nokia at qt-info@nokia.com. |
|
30 |
** |
|
31 |
** |
|
32 |
** |
|
33 |
** |
|
34 |
** |
|
35 |
** |
|
36 |
** |
|
37 |
** |
|
38 |
** $QT_END_LICENSE$ |
|
39 |
** |
|
40 |
****************************************************************************/ |
|
41 |
||
42 |
#include "qnamepool_p.h" |
|
43 |
#include "qxmlnamepool.h" |
|
44 |
||
45 |
QT_BEGIN_NAMESPACE |
|
46 |
||
47 |
/*! |
|
48 |
\class QXmlNamePool |
|
49 |
\brief The QXmlNamePool class is a table of shared strings referenced by instances of QXmlName. |
|
50 |
\reentrant |
|
51 |
\since 4.4 |
|
52 |
\ingroup xml-tools |
|
53 |
||
54 |
QXmlNamePool is used to optimize operations on instances of |
|
55 |
QXmlName. An instance of QXmlName represents an XML name in |
|
56 |
a way that allows the XML name to be compared and passed around |
|
57 |
efficiently. The efficiency is achieved by storing the strings |
|
58 |
comprising the XML names in an instance of QXmlNamePool, where |
|
59 |
they are mapped to binary identifiers, which are then packed |
|
60 |
into a key which is stored in the QXmlName. |
|
61 |
||
62 |
This means that each instance of QXmlName is tied to the name |
|
63 |
pool it was created with, and that name pool should be kept in |
|
64 |
scope and used to create all instances of QXmlName that might |
|
65 |
be compared. Note also that the name pool is required if you |
|
66 |
must reconstitute the QXmlName as text, or if you must access |
|
67 |
any of its component strings, so although instances of |
|
68 |
QXmlName can be compared without reference to a name pool, the |
|
69 |
name pool must be kept in scope if the name's strings must be |
|
70 |
accessed later. |
|
71 |
||
72 |
\sa QXmlName |
|
73 |
\sa QXmlQuery::namePool() |
|
74 |
*/ |
|
75 |
||
76 |
/*! |
|
77 |
Constructs an empty name pool. |
|
78 |
*/ |
|
79 |
QXmlNamePool::QXmlNamePool() : d(new QPatternist::NamePool()) |
|
80 |
{ |
|
81 |
} |
|
82 |
||
83 |
/*! |
|
84 |
Constructs a copy of the \a other name pool. |
|
85 |
*/ |
|
86 |
QXmlNamePool::QXmlNamePool(const QXmlNamePool &other) : d(other.d) |
|
87 |
{ |
|
88 |
} |
|
89 |
||
90 |
/*! |
|
91 |
Destroys the name pool. Instances of QXmlName constructed |
|
92 |
with this name pool can still be compared after this destructor |
|
93 |
is called, but their text strings cannot be accessed. |
|
94 |
*/ |
|
95 |
QXmlNamePool::~QXmlNamePool() |
|
96 |
{ |
|
97 |
} |
|
98 |
||
99 |
QXmlNamePool::QXmlNamePool(QPatternist::NamePool *namePool) : d(QExplicitlySharedDataPointer<QPatternist::NamePool>(namePool)) |
|
100 |
{ |
|
101 |
} |
|
102 |
||
103 |
/*! |
|
104 |
Assigns the \a other name pool to this one. |
|
105 |
*/ |
|
106 |
QXmlNamePool &QXmlNamePool::operator=(const QXmlNamePool &other) |
|
107 |
{ |
|
108 |
d = other.d; |
|
109 |
return *this; |
|
110 |
} |
|
111 |
||
112 |
QT_END_NAMESPACE |
|
113 |