<!DOCTYPE html PUBLIC
"-//W3C//DTD HTML 4.0 Transitional//EN">
<link rel=
"STYLESHEET" href=
"lib.css" type='text/css'
/>
<link rel=
"SHORTCUT ICON" href=
"../icons/pyfav.png" type=
"image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index'
/>
<link rel=
"first" href=
"lib.html" title='Python Library Reference'
/>
<link rel='contents' href='contents.html'
title=
"Contents" />
<link rel='index' href='genindex.html' title='Index'
/>
<link rel='last' href='about.html' title='About this document...'
/>
<link rel='help' href='about.html' title='About this document...'
/>
<link rel=
"next" href=
"module-xmllib.html" />
<link rel=
"prev" href=
"module-xml.sax.saxutils.html" />
<link rel=
"parent" href=
"markup.html" />
<link rel=
"next" href=
"xmlreader-objects.html" />
<meta name='aesop' content='information'
/>
<title>13.12 xml.sax.xmlreader -- Interface for XML parsers
</title>
<div id='top-navigation-panel' xml:id='top-navigation-panel'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"13.11 xml.sax.saxutils "
href=
"module-xml.sax.saxutils.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"parent" title=
"13. Structured Markup Processing"
href=
"markup.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"next" title=
"13.12.1 XMLReader Objects"
href=
"xmlreader-objects.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td><td align=
"center" width=
"100%">Python Library Reference
</td>
<td class='online-navigation'
><a rel=
"contents" title=
"Table of Contents"
href=
"contents.html"><img src='../icons/contents.png'
border='
0' height='
32' alt='Contents' width='
32'
/></A></td><td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td><td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td><div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"module-xml.sax.saxutils.html">13.11 xml.sax.saxutils
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"markup.html">13. Structured Markup Processing
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"xmlreader-objects.html">13.12.1 XMLReader Objects
</A>
<!--End of Navigation Panel-->
<H1><A NAME=
"SECTION00151200000000000000000">
13.12 <tt class=
"module">xml.sax.xmlreader
</tt> --
Interface for XML parsers
</A><A NAME=
"module-xml.sax.xmlreader"></A>
<span class=
"versionnote">New in version
2.0.
</span>
SAX parsers implement the
<tt class=
"class">XMLReader
</tt> interface. They are
implemented in a Python module, which must provide a function
<tt class=
"function">create_parser()
</tt>. This function is invoked by
<tt class=
"function">xml.sax.make_parser()
</tt> with no arguments to create a new
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4516' xml:id='l2h-
4516'
class=
"class">XMLReader
</tt></b>(
</nobr></td>
<td><var></var>)
</td></tr></table></dt>
Base class which can be inherited by SAX parsers.
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4517' xml:id='l2h-
4517'
class=
"class">IncrementalParser
</tt></b>(
</nobr></td>
<td><var></var>)
</td></tr></table></dt>
In some cases, it is desirable not to parse an input source at once,
but to feed chunks of the document as they get available. Note that
the reader will normally not read the entire file, but read it in
chunks as well; still
<tt class=
"method">parse()
</tt> won't return until the entire
document is processed. So these interfaces should be used if the
blocking behaviour of
<tt class=
"method">parse()
</tt> is not desirable.
When the parser is instantiated it is ready to begin accepting data
from the feed method immediately. After parsing has been finished
with a call to close the reset method must be called to make the
parser ready to accept new data, either from feed or using the parse
Note that these methods must
<em>not
</em> be called during parsing,
that is, after parse has been called and before it returns.
By default, the class also implements the parse method of the
XMLReader interface using the feed, close and reset methods of the
IncrementalParser interface as a convenience to SAX
2.0 driver
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4518' xml:id='l2h-
4518'
class=
"class">Locator
</tt></b>(
</nobr></td>
<td><var></var>)
</td></tr></table></dt>
Interface for associating a SAX event with a document location. A
locator object will return valid results only during calls to
DocumentHandler methods; at any other time, the results are
unpredictable. If information is not available, methods may return
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4519' xml:id='l2h-
4519'
class=
"class">InputSource
</tt></b>(
</nobr></td>
<td><var></var><big>[
</big><var>systemId
</var><big>]
</big><var></var>)
</td></tr></table></dt>
Encapsulation of the information needed by the
<tt class=
"class">XMLReader
</tt> to
This class may include information about the public identifier,
system identifier, byte stream (possibly with character encoding
information) and/or the character stream of an entity.
Applications will create objects of this class for use in the
<tt class=
"method">XMLReader.parse()
</tt> method and for returning from
EntityResolver.resolveEntity.
An
<tt class=
"class">InputSource
</tt> belongs to the application, the
<tt class=
"class">XMLReader
</tt> is not allowed to modify
<tt class=
"class">InputSource
</tt> objects
passed to it from the application, although it may make copies and
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4520' xml:id='l2h-
4520'
class=
"class">AttributesImpl
</tt></b>(
</nobr></td>
<td><var>attrs
</var>)
</td></tr></table></dt>
This is an implementation of the
<a class=
"ulink" href=
"attributes-objects.html" ><tt class=
"class">Attributes
</tt>
section
<A href=
"attributes-objects.html#attributes-objects">13.12.5</A>). This is a dictionary-like
object which represents the element attributes in a
<tt class=
"method">startElement()
</tt> call. In addition to the most useful
dictionary operations, it supports a number of other methods as
described by the interface. Objects of this class should be
instantiated by readers;
<var>attrs
</var> must be a dictionary-like
object containing a mapping from attribute names to attribute
<dl><dt><table cellpadding=
"0" cellspacing=
"0"><tr valign=
"baseline">
<td><nobr><b><span class=
"typelabel">class
</span> <tt id='l2h-
4521' xml:id='l2h-
4521'
class=
"class">AttributesNSImpl
</tt></b>(
</nobr></td>
<td><var>attrs, qnames
</var>)
</td></tr></table></dt>
Namespace-aware variant of
<tt class=
"class">AttributesImpl
</tt>, which will be
passed to
<tt class=
"method">startElementNS()
</tt>. It is derived from
<tt class=
"class">AttributesImpl
</tt>, but understands attribute names as
two-tuples of
<var>namespaceURI
</var> and
<var>localname
</var>. In addition,
it provides a number of methods expecting qualified names as they
appear in the original document. This class implements the
<a class=
"ulink" href=
"attributes-ns-objects.html"
><tt class=
"class">AttributesNS
</tt> interface
</a>
(see section
<A href=
"attributes-ns-objects.html#attributes-ns-objects">13.12.6</A>).
<p><br /></p><hr class='online-navigation'
/>
<div class='online-navigation'
>
<!--Table of Child-Links-->
<A NAME=
"CHILD_LINKS"><STRONG>Subsections
</STRONG></a>
<LI><A href=
"xmlreader-objects.html">13.12.1 XMLReader Objects
</a>
<LI><A href=
"incremental-parser-objects.html">13.12.2 IncrementalParser Objects
</a>
<LI><A href=
"locator-objects.html">13.12.3 Locator Objects
</a>
<LI><A href=
"input-source-objects.html">13.12.4 InputSource Objects
</a>
<LI><A href=
"attributes-objects.html">13.12.5 The
<tt class=
"class">Attributes
</tt> Interface
</a>
<LI><A href=
"attributes-ns-objects.html">13.12.6 The
<tt class=
"class">AttributesNS
</tt> Interface
</a>
<!--End of Table of Child-Links-->
<div class='online-navigation'
>
<table align=
"center" width=
"100%" cellpadding=
"0" cellspacing=
"2">
<td class='online-navigation'
><a rel=
"prev" title=
"13.11 xml.sax.saxutils "
href=
"module-xml.sax.saxutils.html"><img src='../icons/previous.png'
border='
0' height='
32' alt='Previous Page' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"parent" title=
"13. Structured Markup Processing"
href=
"markup.html"><img src='../icons/up.png'
border='
0' height='
32' alt='Up One Level' width='
32'
/></A></td><td class='online-navigation'
><a rel=
"next" title=
"13.12.1 XMLReader Objects"
href=
"xmlreader-objects.html"><img src='../icons/next.png'
border='
0' height='
32' alt='Next Page' width='
32'
/></A></td><td align=
"center" width=
"100%">Python Library Reference
</td>
<td class='online-navigation'
><a rel=
"contents" title=
"Table of Contents"
href=
"contents.html"><img src='../icons/contents.png'
border='
0' height='
32' alt='Contents' width='
32'
/></A></td><td class='online-navigation'
><a href=
"modindex.html" title=
"Module Index"><img src='../icons/modules.png'
border='
0' height='
32' alt='Module Index' width='
32'
/></a></td><td class='online-navigation'
><a rel=
"index" title=
"Index"
href=
"genindex.html"><img src='../icons/index.png'
border='
0' height='
32' alt='Index' width='
32'
/></A></td><div class='online-navigation'
>
<b class=
"navlabel">Previous:
</b>
<a class=
"sectref" rel=
"prev" href=
"module-xml.sax.saxutils.html">13.11 xml.sax.saxutils
</A>
<b class=
"navlabel">Up:
</b>
<a class=
"sectref" rel=
"parent" href=
"markup.html">13. Structured Markup Processing
</A>
<b class=
"navlabel">Next:
</b>
<a class=
"sectref" rel=
"next" href=
"xmlreader-objects.html">13.12.1 XMLReader Objects
</A>
<span class=
"release-info">Release
2.4.2, documentation updated on
28 September
2005.
</span>
<!--End of Navigation Panel-->
See
<i><a href=
"about.html">About this document...
</a></i> for information on suggesting changes.
projects / OpenSPARC-T2-SAM / blob