DocumentParser

Class for parsing an XML Document.

This is a subclass of ElementParser. Most of the useful functions are documented there.

Constructors

this
this(string xmlText_)

Constructs a DocumentParser.

Members

Variables

xmlText
string xmlText;
Undocumented in source.

Inherited Members

From ElementParser

Handler
alias Handler = void delegate(string)
Undocumented in source.
ElementHandler
alias ElementHandler = void delegate(in Element element)
Undocumented in source.
ParserHandler
alias ParserHandler = void delegate(ElementParser parser)
Undocumented in source.
tag
const(Tag) tag [@property getter]

The Tag at the start of the element being parsed. You can read this to determine the tag's name and attributes.

onStartTag
ParserHandler[string] onStartTag;

Register a handler which will be called whenever a start tag is encountered which matches the specified name. You can also pass null as the name, in which case the handler will be called for any unmatched start tag.

onEndTag
ElementHandler[string] onEndTag;

Register a handler which will be called whenever an end tag is encountered which matches the specified name. You can also pass null as the name, in which case the handler will be called for any unmatched end tag.

onText
Handler onText [@property setter]

Register a handler which will be called whenever text is encountered.

onTextRaw
void onTextRaw(Handler handler)

Register an alternative handler which will be called whenever text is encountered. This differs from onText in that onText will decode the text, whereas onTextRaw will not. This allows you to make design choices, since onText will be more accurate, but slower, while onTextRaw will be faster, but less accurate. Of course, you can still call decode() within your handler, if you want, but you'd probably want to use onTextRaw only in circumstances where you know that decoding is unnecessary.

onCData
Handler onCData [@property setter]

Register a handler which will be called whenever a character data segment is encountered.

onComment
Handler onComment [@property setter]

Register a handler which will be called whenever a comment is encountered.

onPI
Handler onPI [@property setter]

Register a handler which will be called whenever a processing instruction is encountered.

onXI
Handler onXI [@property setter]

Register a handler which will be called whenever an XML instruction is encountered.

parse
void parse()

Parse an XML element.

toString
string toString()

Returns that part of the element which has already been parsed

Bugs

Currently only supports UTF documents.

If there is an encoding attribute in the prolog, it is ignored.

Meta

Standards

XML 1.0