Python in a Nutshell

Name

ContentHandler

Synopsis

class ContentHandler( )

An instance h of a subclass of ContentHandler may override several methods, of which the most frequently useful are the following:

h .characters( data )

Called when textual content data is parsed. The parser may split each range of text in the document into any number of separate callbacks to h .characters. Therefore, your implementation of method characters usually buffers data, generally by appending it to a list attribute. When your class knows from some other event that all relevant data has arrived, your class calls ''.join on the list and processes the resulting string.

h .endDocument( )

Called once when the document finishes.

h .endElement( tag )

Called when the element named tag finishes.

h .endElementNS( name,qname )

Called when an element finishes and the parser is handling namespaces. name and qname are like for startElementNS, covered later in this chapter.

h .startDocument( )

Called once when the document begins.

h .startElement( tag,attrs )

Called when the element named tag begins. attrs is a mapping of attribute names to values, as covered in the next section.

h .startElementNS( name,qname,attrs )

Called when an element begins and the parser is handling namespaces. name is a pair ( uri,localname ), where uri is the namespace’s URI or None, and localname is the name of the tag. qname (which stands for qualified name) is either None, if the parser does not supply the namespace prefixes feature, or the string ...