class xml::XParser

sys::Obj
  xml::XParser

@Js

Source

XParser is a simple, lightweight XML parser. It may be used as a pull parser by iterating through the element and text sections of an XML stream or it may be used to read an entire XML tree into memory as XElems.

close

Bool close()

Source

Close the underlying input stream. Return true if the stream was closed successfully or false if the stream was closed abnormally.

col

Int col := 1 { private set }

Source

Current one based column number.

depth

Int depth := -1 { private set }

Source

Get the depth of the current element with the document. A depth of zero indicates the root element. A depth of -1 indicates a position before or after the root element.

doc

XDoc doc := XDoc.<ctor>() { private set }

Source

Get the root document node.

elem

XElem? elem()

Source

Get the current element if nodeType is elemStart or elemEnd. If nodeType is text or pi then this is the parent element. After elemEnd this XElem instance is no longer valid and will be reused for further processing. If depth is -1 return null.

elemAt

XElem elemAt(Int depth)

Source

Get the element at the specified depth. Depth must be between 0 and depth inclusively. Calling elemAt(0) will return the root element and elemAt(depth) returns the current element. If depth is invalid IndexErr is thrown.

line

Int line := 1 { private set }

Source

Current one based line number.

make

new make(InStream in)

Source

Construct input stream to read.

next

XNodeType? next()

Source

Advance the parser to the next node and return the node type. Return the current node type:

nodeType

XNodeType? nodeType { private set }

Source

Get the current node type constant which is always the result of the last call to next. Node type will be:

parseDoc

XDoc parseDoc(Bool close := true)

Source

Parse the entire document into memory as a tree of XElems and optionally close the underlying input stream.

parseElem

XElem parseElem(Bool close := true)

Source

Parse the current element entirely into memory as a tree of XElems and optionally close the underlying input stream.

pi

XPi? pi()

Source

if the current node type is pi return the XPi instance otherwise return null.

skip

Void skip(Int toDepth := this.depth)

Source

Skip parses all the content until reaching the end tag of the specified depth. When this method returns, the next call to next will return the node immediately following the end tag.

text

XText? text()

Source

If the current type is text the XText instance used to store the character data. After a call to next this XText instance is no longer valid and will be reused for further processing. If the current type is not text then return null.