Name
xml_store_tree, xml_expand_refs — store an XML parse tree on disk and expand entity references
Synopsis
xml_store_tree(
|
in tree any, |
| in id1 varbinary, | |
| in id2 varbinary, | |
in level integer); |
any xml_expand_refs(
|
in tree any); |
Description
xml_store_tree persists an in-memory XML parse tree
(as built by
xtree_doc or the
xte_node* family) into the server's XML object store.
The id1 and id2 binaries
identify the root and parent entities; level is the
storage level/depth marker used by the schema mapper. This is used
internally by xper-style XML storage and by the SQL/XML view machinery.
xml_expand_refs returns a deep copy of
tree with all internal entity references resolved
against the document's DTD. Use it when handing a parse tree to consumers
that do not themselves perform entity expansion (for example simple text
extractors or non-validating serializers).