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
|
'\" t
.TH QXmlReader 3qt "18 March 2002" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2001 Trolltech AS. All rights reserved. See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QXmlReader \- Interface for XML readers (i.e. parsers)
.SH SYNOPSIS
\fC#include <qxml.h>\fR
.PP
Inherited by QXmlSimpleReader.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "virtual bool \fBfeature\fR ( const QString & name, bool * ok = 0 ) const = 0"
.br
.ti -1c
.BI "virtual void \fBsetFeature\fR ( const QString & name, bool value ) = 0"
.br
.ti -1c
.BI "virtual bool \fBhasFeature\fR ( const QString & name ) const = 0"
.br
.ti -1c
.BI "virtual void * \fBproperty\fR ( const QString & name, bool * ok = 0 ) const = 0"
.br
.ti -1c
.BI "virtual void \fBsetProperty\fR ( const QString & name, void * value ) = 0"
.br
.ti -1c
.BI "virtual bool \fBhasProperty\fR ( const QString & name ) const = 0"
.br
.ti -1c
.BI "virtual void \fBsetEntityResolver\fR ( QXmlEntityResolver * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlEntityResolver * \fBentityResolver\fR () const = 0"
.br
.ti -1c
.BI "virtual void \fBsetDTDHandler\fR ( QXmlDTDHandler * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlDTDHandler * \fBDTDHandler\fR () const = 0"
.br
.ti -1c
.BI "virtual void \fBsetContentHandler\fR ( QXmlContentHandler * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlContentHandler * \fBcontentHandler\fR () const = 0"
.br
.ti -1c
.BI "virtual void \fBsetErrorHandler\fR ( QXmlErrorHandler * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlErrorHandler * \fBerrorHandler\fR () const = 0"
.br
.ti -1c
.BI "virtual void \fBsetLexicalHandler\fR ( QXmlLexicalHandler * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlLexicalHandler * \fBlexicalHandler\fR () const = 0"
.br
.ti -1c
.BI "virtual void \fBsetDeclHandler\fR ( QXmlDeclHandler * handler ) = 0"
.br
.ti -1c
.BI "virtual QXmlDeclHandler * \fBdeclHandler\fR () const = 0"
.br
.ti -1c
.BI "virtual bool parse ( const QXmlInputSource & input ) = 0 \fI(obsolete)\fR"
.br
.ti -1c
.BI "virtual bool \fBparse\fR ( const QXmlInputSource * input ) = 0"
.br
.in -1c
.SH DESCRIPTION
The QXmlReader class provides an interface for XML readers (i.e. parsers).
.PP
This abstract class provides an interface for all XML readers in Qt. At the moment there is only one implementation of a reader included in the XML module of Qt (QXmlSimpleReader). In future releases there might be more readers with different properties available (e.g. a validating parser).
.PP
The design of the XML classes follows the SAX2 java interface. It was adapted to fit the Qt naming conventions; so it should be very easy for anybody who has worked with SAX2 to get started with the Qt XML classes.
.PP
All readers use the class QXmlInputSource to read the input document. Since you are normally interested in particular content in the XML document, the reader reports the content through special handler classes (QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler and QXmlLexicalHandler), which you must subclass, if you want to process the contents..
.PP
Since the handler classes describe only interfaces you must implement all functions; there is a class (QXmlDefaultHandler) to make this easier; it implements a default behaviour (do nothing) for all functions.
.PP
Features and properties of the reader can be set with setFeature() and setProperty respectively. You can set the reader to use your own subclasses with setEntityResolver(), setDTDHandler(), setContentHandler(), setErrorHandler(), setLexicalHandler() and setDeclHandler(). The parse itself is started with a call to parse().
.PP
For getting started see also the tiny SAX2 parser walkthrough.
.PP
See also QXmlSimpleReader and XML.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QXmlDTDHandler * QXmlReader::DTDHandler () const\fC [pure virtual]\fR"
Returns the DTD handler or 0 if none was set.
.PP
See also setDTDHandler().
.SH "QXmlContentHandler * QXmlReader::contentHandler () const\fC [pure virtual]\fR"
Returns the content handler or 0 if none was set.
.PP
See also setContentHandler().
.SH "QXmlDeclHandler * QXmlReader::declHandler () const\fC [pure virtual]\fR"
Returns the declaration handler or 0 if none was set.
.PP
See also setDeclHandler().
.SH "QXmlEntityResolver * QXmlReader::entityResolver () const\fC [pure virtual]\fR"
Returns the entity resolver or 0 if none was set.
.PP
See also setEntityResolver().
.SH "QXmlErrorHandler * QXmlReader::errorHandler () const\fC [pure virtual]\fR"
Returns the error handler or 0 if none was set.
.PP
See also setErrorHandler().
.SH "bool QXmlReader::feature ( const QString & name, bool * ok = 0 ) const\fC [pure virtual]\fR"
If the reader has the feature called \fIname\fR, the feature's value is returned. If no such feature exists the return value is undefined.
.PP
If \fIok\fR is not 0, then \fI*ok\fR is set to TRUE if the reader has the feature called \fIname\fR; otherwise \fI*ok\fR is set to FALSE.
.PP
See also setFeature() and hasFeature().
.SH "bool QXmlReader::hasFeature ( const QString & name ) const\fC [pure virtual]\fR"
Returns \fCTRUE\fR if the reader has the feature \fIname\fR; otherwise returns FALSE.
.PP
See also feature() and setFeature().
.SH "bool QXmlReader::hasProperty ( const QString & name ) const\fC [pure virtual]\fR"
Returns TRUE if the reader has the property \fIname\fR; otherwise returns FALSE.
.PP
See also property() and setProperty().
.SH "QXmlLexicalHandler * QXmlReader::lexicalHandler () const\fC [pure virtual]\fR"
Returns the lexical handler or 0 if none was set.
.PP
See also setLexicalHandler().
.SH "bool QXmlReader::parse ( const QXmlInputSource * input )\fC [pure virtual]\fR"
Reads an XML document from \fIinput\fR and parses it. Returns TRUE if the parsing was successful; otherwise returns FALSE.
.PP
Examples:
.)l xml/tagreader-with-features/tagreader.cpp and xml/tagreader/tagreader.cpp.
.SH "bool QXmlReader::parse ( const QXmlInputSource & input )\fC [pure virtual]\fR"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.SH "void * QXmlReader::property ( const QString & name, bool * ok = 0 ) const\fC [pure virtual]\fR"
If the reader has the property \fIname\fR, this function returns the value of the property and sets \fI*ok\fR to TRUE; otherwise \fI*ok\fR is set to FALSE.
.PP
See also setProperty() and hasProperty().
.SH "void QXmlReader::setContentHandler ( QXmlContentHandler * handler )\fC [pure virtual]\fR"
Sets the content handler to \fIhandler\fR.
.PP
See also contentHandler().
.PP
Examples:
.)l xml/tagreader-with-features/tagreader.cpp and xml/tagreader/tagreader.cpp.
.SH "void QXmlReader::setDTDHandler ( QXmlDTDHandler * handler )\fC [pure virtual]\fR"
Sets the DTD handler to \fIhandler\fR.
.PP
See also DTDHandler().
.SH "void QXmlReader::setDeclHandler ( QXmlDeclHandler * handler )\fC [pure virtual]\fR"
Sets the declaration handler to \fIhandler\fR.
.PP
See also declHandler().
.SH "void QXmlReader::setEntityResolver ( QXmlEntityResolver * handler )\fC [pure virtual]\fR"
Sets the entity resolver to \fIhandler\fR.
.PP
See also entityResolver().
.SH "void QXmlReader::setErrorHandler ( QXmlErrorHandler * handler )\fC [pure virtual]\fR"
Sets the error handler to \fIhandler\fR. Clears the error handler if \fIhandler\fR is 0.
.PP
See also errorHandler().
.SH "void QXmlReader::setFeature ( const QString & name, bool value )\fC [pure virtual]\fR"
Sets the feature called \fIname\fR to the given \fIvalue\fR. If the reader doesn't have the feature nothing happens.
.PP
See also feature() and hasFeature().
.PP
Example: xml/tagreader-with-features/tagreader.cpp.
.SH "void QXmlReader::setLexicalHandler ( QXmlLexicalHandler * handler )\fC [pure virtual]\fR"
Sets the lexical handler to \fIhandler\fR.
.PP
See also lexicalHandler().
.SH "void QXmlReader::setProperty ( const QString & name, void * value )\fC [pure virtual]\fR"
Sets the property \fIname\fR to \fIvalue\fR. If the reader doesn't have the property nothing happens.
.PP
See also property() and hasProperty().
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qxmlreader.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive Qt documentation is provided in HTML format; it is
located at $QTDIR/doc/html and can be read using Qt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech.
.P
If you find errors in this manual page, please report them to
.BR qt-bugs@trolltech.com .
Please include the name of the manual page (qxmlreader.3qt) and the Qt
version (3.0.3).
|
