2 * Copyright 2001-2007 Internet2
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 * @file xmltooling/QName.h
20 * Representing XML QNames
23 #ifndef __xmltooling_qname_h__
24 #define __xmltooling_qname_h__
26 #include <xmltooling/unicode.h>
29 namespace xmltooling {
31 #if defined (_MSC_VER)
32 #pragma warning( push )
33 #pragma warning( disable : 4251 )
37 * A data structure for encapsulating XML QNames.
38 * The Xerces class is too limited to use at the moment.
40 class XMLTOOL_API QName
46 * @param uri namespace URI
47 * @param localPart local name
48 * @param prefix namespace prefix (without the colon)
50 QName(const XMLCh* uri=NULL, const XMLCh* localPart=NULL, const XMLCh* prefix=NULL);
55 * @param uri namespace URI
56 * @param localPart local name
57 * @param prefix namespace prefix (without the colon)
59 QName(const char* uri, const char* localPart, const char* prefix=NULL);
64 * Deep copy constructor
66 QName(const QName& src);
69 * Deep assignment operator
71 QName& operator=(const QName& src);
76 * Indicates whether the QName has a prefix.
77 * @return true iff the prefix is non-empty
79 bool hasPrefix() const { return !m_prefix.empty(); }
82 * Indicates whether the QName has a non-empty namespace.
83 * @return true iff the namespace is non-empty
85 bool hasNamespaceURI() const { return !m_uri.empty(); }
88 * Indicates whether the QName has a non-empty local name.
89 * @return true iff the local name is non-empty
91 bool hasLocalPart() const { return !m_local.empty(); }
94 * Returns the namespace prefix
95 * @return Null-terminated Unicode string containing the prefix, without the colon
97 const XMLCh* getPrefix() const { return m_prefix.c_str(); }
100 * Returns the namespace URI
101 * @return Null-terminated Unicode string containing the URI
103 const XMLCh* getNamespaceURI() const { return m_uri.c_str(); }
106 * Returns the local part of the name
107 * @return Null-terminated Unicode string containing the local name
109 const XMLCh* getLocalPart() const { return m_local.c_str(); }
112 * Indicates whether the QName has a prefix.
113 * @return true iff the prefix is non-empty
115 bool hasPrefix() const { return m_prefix && *m_prefix; }
118 * Indicates whether the QName has a non-empty namespace.
119 * @return true iff the namespace is non-empty
121 bool hasNamespaceURI() const { return m_uri && *m_uri; }
124 * Indicates whether the QName has a non-empty local name.
125 * @return true iff the local name is non-empty
127 bool hasLocalPart() const { return m_local && *m_local; }
130 * Returns the namespace prefix
131 * @return Null-terminated Unicode string containing the prefix, without the colon
133 const XMLCh* getPrefix() const { return m_prefix; }
136 * Returns the namespace URI
137 * @return Null-terminated Unicode string containing the URI
139 const XMLCh* getNamespaceURI() const { return m_uri; }
142 * Returns the local part of the name
143 * @return Null-terminated Unicode string containing the local name
145 const XMLCh* getLocalPart() const { return m_local; }
149 * Sets the namespace prefix
150 * @param prefix Null-terminated Unicode string containing the prefix, without the colon
152 void setPrefix(const XMLCh* prefix);
155 * Sets the namespace URI
156 * @param uri Null-terminated Unicode string containing the URI
158 void setNamespaceURI(const XMLCh* uri);
161 * Sets the local part of the name
162 * @param localPart Null-terminated Unicode string containing the local name
164 void setLocalPart(const XMLCh* localPart);
167 * Sets the namespace prefix
168 * @param prefix Null-terminated ASCII string containing the prefix, without the colon
170 void setPrefix(const char* prefix);
173 * Sets the namespace URI
174 * @param uri Null-terminated ASCII string containing the URI
176 void setNamespaceURI(const char* uri);
179 * Sets the local part of the name
180 * @param localPart Null-terminated ASCII string containing the local name
182 void setLocalPart(const char* localPart);
185 * Gets a string representation of the QName for logging, etc.
186 * Format is prefix:localPart or {namespaceURI}localPart if no prefix.
188 * @return the string representation
190 std::string toString() const;
204 #if defined (_MSC_VER)
205 #pragma warning( pop )
209 * Returns true iff op1's namespace lexically compares less than op2's namespace,
210 * or if equal, iff op1's prefix lexically compares less than op2's prefix.
212 * Needed for use with sorted STL containers.
214 * @param op1 First qname to compare
215 * @param op2 Second qname to compare
217 extern XMLTOOL_API bool operator<(const QName& op1, const QName& op2);
220 * Returns true iff op1's components are equal to op2's components, excluding prefix.
221 * @param op1 First qname to compare
222 * @param op2 Second qname to compare
224 extern XMLTOOL_API bool operator==(const QName& op1, const QName& op2);
227 * Returns true iff op1's components are not equal to op2's components, excluding prefix.
228 * @param op1 First qname to compare
229 * @param op2 Second qname to compare
231 extern XMLTOOL_API bool operator!=(const QName& op1, const QName& op2);
235 #endif /* __xmltooling_qname_h__ */