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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Qt Toolkit - QXmlNamespaceSupport Class</title><style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }body { background: white; color: black; }
--></style>
</head><body bgcolor="#ffffff">
<table width="100%">
<tr><td><a href="index.html">
<img width="100" height="100" src="qtlogo.png"
alt="Home" border="0"><img width="100"
height="100" src="face.png" alt="Home" border="0">
</a><td valign=top><div align=right><img src="dochead.png" width="472" height="27"><br>
<a href="classes.html"><b>Classes</b></a>
-<a href="annotated.html">Annotated</a>
- <a href="hierarchy.html">Tree</a>
-<a href="functions.html">Functions</a>
-<a href="index.html">Home</a>
-<a href="topicals.html"><b>Structure</b></a>
</div>
</table>
<h1 align=center>QXmlNamespaceSupport Class Reference<br><small>[ <a href="xml.html">XML module</a> ]</small></h1><br clear="all">
<p>
The QXmlNamespaceSupport class is a helper class for XML readers which want to include namespace support.
<a href="#details">More...</a>
<p>
<code>#include <<a href="qxml-h.html">qxml.h</a>></code>
<p><a href="qxmlnamespacesupport-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class="fn"><a href="#daf40a"><b>QXmlNamespaceSupport</b></a>()</div>
<li><div class="fn"><a href="#cc9b28"><b>~QXmlNamespaceSupport</b></a>()</div>
<li><div class="fn">void<a href="#ad2e00"><b>setPrefix</b></a>(constQString&, constQString&)</div>
<li><div class="fn">QString<a href="#776ba7"><b>prefix</b></a>(constQString&)const</div>
<li><div class="fn">QString<a href="#e626a6"><b>uri</b></a>(constQString&)const</div>
<li><div class="fn">void<a href="#8c6934"><b>splitName</b></a>(constQString&, QString&, QString&)const</div>
<li><div class="fn">void<a href="#c434d8"><b>processName</b></a>(constQString&, bool, QString&, QString&)const</div>
<li><div class="fn">QStringList<a href="#5ff2ba"><b>prefixes</b></a>()const</div>
<li><div class="fn">QStringList<a href="#ec46d6"><b>prefixes</b></a>(constQString&)const</div>
<li><div class="fn">void<a href="#639564"><b>pushContext</b></a>()</div>
<li><div class="fn">void<a href="#989b2b"><b>popContext</b></a>()</div>
<li><div class="fn">void<a href="#eb4942"><b>reset</b></a>()</div>
</ul>
<hr><h2><a name="details"></a>Detailed Description</h2>
The QXmlNamespaceSupport class is a helper class for XML readers which want to include namespace support.
<p>
It provides some functions that makes it easy to handle namespaces. Its main
use is for subclasses of <a href="qxmlreader.html">QXmlReader</a> which want to provide namespace
support.
<p>See also the <a href="xml-sax.html#namespaces">namespace description</a>
<hr><h2>Member Function Documentation</h2>
<h3 class="fn"><a name="daf40a"></a>QXmlNamespaceSupport::QXmlNamespaceSupport()</h3>
<p>Constructs a QXmlNamespaceSupport.
<h3 class="fn"><a name="cc9b28"></a>QXmlNamespaceSupport::~QXmlNamespaceSupport()</h3>
<p>Destructs a QXmlNamespaceSupport.
<h3 class="fn">void<a name="989b2b"></a>QXmlNamespaceSupport::popContext()</h3>
<p>Reverts to the previous namespace context.
<p>Normally, you should pop the context at the end of each XML element. After
popping the context, all namespace prefix mappings that were previously in
force are restored.
<h3 class="fn"><a href="qstring.html">QString</a><a name="776ba7"></a>QXmlNamespaceSupport::prefix(const<a href="qstring.html">QString</a>&uri)const</h3>
<p>Returns one of the prefixes mapped to a namespace URI.
<p>If more than one prefix is currently mapped to the same URI, this function
will make an arbitrary selection; if you want all of the prefixes, use the
<a href="#5ff2ba">prefixes</a>() function instead.
<p>Note: this will never return the empty (default) prefix; to check for a
default prefix, use the <a href="#e626a6">uri</a>() function with an argument of "".
<h3 class="fn"><a href="qstringlist.html">QStringList</a><a name="5ff2ba"></a>QXmlNamespaceSupport::prefixes()const</h3>
<p>Returns an enumeration of all prefixes currently declared.
<p>Note: if there is a default prefix, it will not be returned in this
enumeration; check for the default prefix using <a href="#e626a6">uri</a>() with an argument
of "".
<h3 class="fn"><a href="qstringlist.html">QStringList</a><a name="ec46d6"></a>QXmlNamespaceSupport::prefixes(const<a href="qstring.html">QString</a>&uri)const</h3>
<p>Returns a list of all prefixes currently declared for a URI.
<p>The xml: prefix will be included. If you want only one prefix that's
mapped to the namespace URI, and you don't care which one you get, use the
<a href="#776ba7">prefix</a>() function instead.
<p>Note: the empty (default) prefix is never included in this enumeration; to
check for the presence of a default namespace, use <a href="#e626a6">uri</a>() with an
argument of "".
<h3 class="fn">void<a name="c434d8"></a>QXmlNamespaceSupport::processName(const<a href="qstring.html">QString</a>&qname, boolisAttribute, <a href="qstring.html">QString</a>&nsuri, <a href="qstring.html">QString</a>&localname)const</h3>
<p>Processes a raw XML 1.0 name in the current context by removing the prefix
and looking it up among the prefixes currently declared.
<p>First parameter is the raw XML 1.0 name to be processed. The second parameter
is a flag wheter the name is the name of an attribute (TRUE) or not (FALSE).
<p>The return values will be stored in the last two parameters as follows:
<ul>
<li> The namespace URI, or an empty string if none is in use.
<li> The local name (without prefix).
</ul>
<p>If the raw name has a prefix that has not been declared, then the return
value will be empty.
<p>Note that attribute names are processed differently than element names: an
unprefixed element name will received the default namespace (if any), while
an unprefixed element name will not.
<h3 class="fn">void<a name="639564"></a>QXmlNamespaceSupport::pushContext()</h3>
<p>Starts a new namespace context.
<p>Normally, you should push a new context at the beginning of each XML element:
the new context will automatically inherit the declarations of its parent
context, but it will also keep track of which declarations were made within
this context.
<h3 class="fn">void<a name="eb4942"></a>QXmlNamespaceSupport::reset()</h3>
<p>Resets this namespace support object for reuse.
<h3 class="fn">void<a name="ad2e00"></a>QXmlNamespaceSupport::setPrefix(const<a href="qstring.html">QString</a>&pre, const<a href="qstring.html">QString</a>&uri)</h3>
<p>This function declares a prefix in the current namespace context; the prefix
will remain in force until this context is popped, unless it is shadowed in a
descendant context.
<p>Note that there is an asymmetry in this library: while <a href="#776ba7">prefix</a>() will not
return the default "" prefix, even if you have declared one; to check for a
default prefix, you have to look it up explicitly using <a href="#e626a6">uri</a>(). This
asymmetry exists to make it easier to look up prefixes for attribute names,
where the default prefix is not allowed.
<h3 class="fn">void<a name="8c6934"></a>QXmlNamespaceSupport::splitName(const<a href="qstring.html">QString</a>&qname, <a href="qstring.html">QString</a>&prefix, <a href="qstring.html">QString</a>&localname)const</h3>
<p>Splits the name at the ':' and returns the prefix and the local name.
<h3 class="fn"><a href="qstring.html">QString</a><a name="e626a6"></a>QXmlNamespaceSupport::uri(const<a href="qstring.html">QString</a>&prefix)const</h3>
<p>Looks up a prefix in the current context and returns the currently-mapped
namespace URI. Use the empty string ("") for the default namespace.
<hr><p>
Search the documentation, FAQ, qt-interest archive and more (uses
<a href="http://www.trolltech.com">www.trolltech.com</a>):<br>
<form method=post action="http://www.trolltech.com/search.cgi">
<input type=hidden name="version" value="2.3.2"><nobr>
<input size="50" name="search"><input type=submit value="Search">
</nobr></form><hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>,
copyright © 1995-2001
<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 2001 Trolltech<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align="right"><div align="right">Qt version 2.3.2</div>
</table></div></address></body></html>
|
