For information on converting to InterSystems IRIS,
see the InterSystems IRIS Adoption Guide
and the InterSystems IRIS In-Place Conversion Guide,
both available on the WRC Distributions page (login required).
Implements an interface to the XPATH Document. XML contained in a file or binary stream
may be selected and navigated. %XML.XPATH.Document should never be created directly with
%New(), but via the CreateFromFile() or CreateFromStream() factory methods
This holds a string specifying prefix mappings for the document. This is a comma delimited list
of prefix to namespace mappings. Each mapping is defined as a prefix, a space and then the uri to
which that prefix maps. This is especially useful if the document defines a default namespace with the
xmlns="http://somenamespaceuri" syntax but does not supply an explicit prefix mapping. For example, this
PrefixMappings string would map the myprefix prefix to the http://somenamespaceuri uri.
This callback method is invoked by the %New() method to
provide notification that a new instance of an object is being created.
For this class, client code should NOT call this method directly via %New()
but should use the 'CreateFromFile()' or 'CreateFromStream()' factory methods
Use this method to create an instance of an %XML.XPATH.Document from a binary stream. It's important to use a binary stream because
if a character stream is used then (for a unicode cache) the characters will be automatically converted to unicode (utf-16). This can
cause a problem if the XML stream has a header declaring a different coding as it introduces an inconsistency between the
declared encoding and the actual encoding. This will cause the XML Parser to issue an error message and fail.
This method evaluates an XPATH context and expression. The context selects the intial nodeset from the document and
the expression further filters the node set. See
http://www.w3.org/TR/xpath for full details of XPATH syntax and usage
If the method succeeds it returns a list of Results which can be queried for their types and values.
Evaluates an XPATH expression which returns a DOM Result
Evaluates an XPATH expression which returns a VALUE Result
Evaluates an XPATH expression which returns a VALUE Result ( demonstrates use of CreateFromString() )
classmethod ExampleDisplayResults(pResults As %ListOfObjects(CLASSNAME="%XML.XPATH.Result"))