summaryrefslogtreecommitdiffstats
path: root/doc/html/qxmlattributes.html
blob: 76694460fd39a4829cf65e0d9dc93d534ed95c0a (plain)
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
<!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/xml/qxml.cpp:647 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QXmlAttributes 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&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>QXmlAttributes Class Reference<br><small>[<a href="xml.html">XML module</a>]</small></h1>

<p>The QXmlAttributes class provides XML attributes.
<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 &lt;<a href="qxml-h.html">qxml.h</a>&gt;</tt>
<p><a href="qxmlattributes-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QXmlAttributes"><b>QXmlAttributes</b></a> ()</li>
<li class=fn>virtual <a href="#~QXmlAttributes"><b>~QXmlAttributes</b></a> ()</li>
<li class=fn>int <a href="#index"><b>index</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;qName ) const</li>
<li class=fn>int <a href="#index-2"><b>index</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;uri, const&nbsp;QString&nbsp;&amp;&nbsp;localPart ) const</li>
<li class=fn>int <a href="#length"><b>length</b></a> () const</li>
<li class=fn>int <a href="#count"><b>count</b></a> () const</li>
<li class=fn>QString <a href="#localName"><b>localName</b></a> ( int&nbsp;index ) const</li>
<li class=fn>QString <a href="#qName"><b>qName</b></a> ( int&nbsp;index ) const</li>
<li class=fn>QString <a href="#uri"><b>uri</b></a> ( int&nbsp;index ) const</li>
<li class=fn>QString <a href="#type"><b>type</b></a> ( int&nbsp;index ) const</li>
<li class=fn>QString <a href="#type-2"><b>type</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;qName ) const</li>
<li class=fn>QString <a href="#type-3"><b>type</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;uri, const&nbsp;QString&nbsp;&amp;&nbsp;localName ) const</li>
<li class=fn>QString <a href="#value"><b>value</b></a> ( int&nbsp;index ) const</li>
<li class=fn>QString <a href="#value-2"><b>value</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;qName ) const</li>
<li class=fn>QString <a href="#value-3"><b>value</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;uri, const&nbsp;QString&nbsp;&amp;&nbsp;localName ) const</li>
<li class=fn>void <a href="#clear"><b>clear</b></a> ()</li>
<li class=fn>void <a href="#append"><b>append</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;qName, const&nbsp;QString&nbsp;&amp;&nbsp;uri, const&nbsp;QString&nbsp;&amp;&nbsp;localPart, const&nbsp;QString&nbsp;&amp;&nbsp;value )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>



The QXmlAttributes class provides XML attributes.

<p> 

<p> If attributes are reported by <a href="qxmlcontenthandler.html#startElement">QXmlContentHandler::startElement</a>()
this class is used to pass the attribute values.
<p> Use <a href="#index">index</a>() to locate the position of an attribute in the list,
<a href="#count">count</a>() to retrieve the number of attributes, and <a href="#clear">clear</a>() to
remove the attributes. New attributes can be added with <a href="#append">append</a>().
Use <a href="#type">type</a>() to get an attribute's type and <a href="#value">value</a>() to get its
value. The attribute's name is available from <a href="#localName">localName</a>() or
<a href="#qName">qName</a>(), and its namespace URI from <a href="#uri">uri</a>().
<p> <p>See also <a href="xml-tools.html">XML</a>.

<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QXmlAttributes"></a>QXmlAttributes::QXmlAttributes ()
</h3>

<p> Constructs an empty attribute list.

<h3 class=fn><a name="~QXmlAttributes"></a>QXmlAttributes::~QXmlAttributes ()<tt> [virtual]</tt>
</h3>

<p> Destroys the attributes object.

<h3 class=fn>void <a name="append"></a>QXmlAttributes::append ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;qName, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;uri, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;localPart, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;value )
</h3>
Appends a new attribute entry to the list of attributes. The
qualified name of the attribute is <em>qName</em>, the namespace URI is
<em>uri</em> and the local name is <em>localPart</em>. The value of the
attribute is <em>value</em>.
<p> <p>See also <a href="#qName">qName</a>(), <a href="#uri">uri</a>(), <a href="#localName">localName</a>(), and <a href="#value">value</a>().

<h3 class=fn>void <a name="clear"></a>QXmlAttributes::clear ()
</h3>
Clears the list of attributes.
<p> <p>See also <a href="#append">append</a>().

<h3 class=fn>int <a name="count"></a>QXmlAttributes::count () const
</h3>

<p> Returns the number of attributes in the list. This function is
equivalent to <a href="#length">length</a>().

<h3 class=fn>int <a name="index"></a>QXmlAttributes::index ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;qName ) const
</h3>
Looks up the index of an attribute by the qualified name <em>qName</em>.
<p> Returns the index of the attribute or -1 if it wasn't found.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<h3 class=fn>int <a name="index-2"></a>QXmlAttributes::index ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;uri, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;localPart ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Looks up the index of an attribute by a namespace name.
<p> <em>uri</em> specifies the namespace URI, or an empty string if the name
has no namespace URI. <em>localPart</em> specifies the attribute's local
name.
<p> Returns the index of the attribute, or -1 if it wasn't found.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<h3 class=fn>int <a name="length"></a>QXmlAttributes::length () const
</h3>
Returns the number of attributes in the list.
<p> <p>See also <a href="#count">count</a>().

<p>Example: <a href="tagreader-with-features-example.html#x1967">xml/tagreader-with-features/structureparser.cpp</a>.
<h3 class=fn><a href="qstring.html">QString</a> <a name="localName"></a>QXmlAttributes::localName ( int&nbsp;index ) const
</h3>
Looks up an attribute's local name for the attribute at position
<em>index</em>. If no namespace processing is done, the local name is
<a href="qstring.html#QString-null">QString::null</a>.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<h3 class=fn><a href="qstring.html">QString</a> <a name="qName"></a>QXmlAttributes::qName ( int&nbsp;index ) const
</h3>
Looks up an attribute's XML 1.0 qualified name for the attribute
at position <em>index</em>.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<p>Example: <a href="qlistview.html#x2106">xml/tagreader-with-features/structureparser.cpp</a>.
<h3 class=fn><a href="qstring.html">QString</a> <a name="type"></a>QXmlAttributes::type ( int&nbsp;index ) const
</h3>
Looks up an attribute's type for the attribute at position <em>index</em>.
<p> Currently only "CDATA" is returned.

<h3 class=fn><a href="qstring.html">QString</a> <a name="type-2"></a>QXmlAttributes::type ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;qName ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Looks up an attribute's type for the qualified name <em>qName</em>.
<p> Currently only "CDATA" is returned.

<h3 class=fn><a href="qstring.html">QString</a> <a name="type-3"></a>QXmlAttributes::type ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;uri, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;localName ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Looks up an attribute's type by namespace name.
<p> <em>uri</em> specifies the namespace URI and <em>localName</em> specifies the
local name. If the name has no namespace URI, use an empty string
for <em>uri</em>.
<p> Currently only "CDATA" is returned.

<h3 class=fn><a href="qstring.html">QString</a> <a name="uri"></a>QXmlAttributes::uri ( int&nbsp;index ) const
</h3>
Looks up an attribute's namespace URI for the attribute at
position <em>index</em>. If no namespace processing is done or if the
attribute has no namespace, the namespace URI is <a href="qstring.html#QString-null">QString::null</a>.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<p>Example: <a href="qlistview.html#x2107">xml/tagreader-with-features/structureparser.cpp</a>.
<h3 class=fn><a href="qstring.html">QString</a> <a name="value"></a>QXmlAttributes::value ( int&nbsp;index ) const
</h3>
Looks up an attribute's value for the attribute at position <em>index</em>.

<h3 class=fn><a href="qstring.html">QString</a> <a name="value-2"></a>QXmlAttributes::value ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;qName ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Looks up an attribute's value for the qualified name <em>qName</em>.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<h3 class=fn><a href="qstring.html">QString</a> <a name="value-3"></a>QXmlAttributes::value ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;uri, const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;localName ) const
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Looks up an attribute's value by namespace name.
<p> <em>uri</em> specifies the namespace URI, or an empty string if the name
has no namespace URI. <em>localName</em> specifies the attribute's local
name.
<p> See also the <a href="xml.html#sax2Namespaces">namespace description</a>.

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright &copy; 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 &copy; 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>