Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator First Added:
Operator Altered:
Function [other Function type actions]
Item [operators of similar scope]
Stream parsing [other Stream parsing operators]
9.1.0
Stream.xml(path)
If there is no current XML object, attempts to parse the string as XML and fails if unsuccessful. If there is a current XML object, it will be reused.
Returns a specific piece of data from the XML object, determined by the path. path should be an expression or a quoted string. path is a subset of the Xpath standard.
Consider this source stream:
<shelf>
<book price="9.95">War and Peace</book>
<book price="4.95">No et Moi</book>
<audio price="14.95">Born To Run</book>
</shelf>Examples of path:
-
/shelf/book: returns a list of children if the shelf object that are books. "War and Peace;No et Moi" -
/shelf/book[2]: returns the child of the shelf object that represents the second book. -
/shelf/book@price: returns the price attribute of each book.
To accord with standard XML and XPath usage, the first child of an XML node is child [1], not [0]. XML attributes are not related to Tinderbox attributes.