Berkeley DB XML Reference Guide: dbxml:node()

Berkeley DB XML Reference Guide:
Berkeley DB XML XQuery Extensions

dbxml:node()

dbxml:handle-to-node($containerName as xs:string, $handle as xs:string) as node()

dbxml:node-to-handle() as xs:string

dbxml:node-to-handle($node as node()) as xs:string

Description: dbxml:handle-to-node()

dbxml:handle-to-node() will return the node from the specified container as referenced by the handle. If the specified container does not exist or cannot be opened an error is raised. An error is raised if the handle is invalid or the node specified does not exist.

Description: dbxml:node-to-handle()

dbxml:node-to-handle() will return an opaque node "handle" for the given node. The string returned is base-64 encoded raw data, and is suitable for embedding in a URI. The handle can be used to retrieve the node at a later time, if the node is still present in its container, using dbxml:handle-to-node().

Parameters
$containerName

The name of the container to use to find the specified node.

$handle

A string handle representing a node in a container. This handle must be obtained using dbxml:node-to-handle() or XmlValue::getNodeHandle.

$node

The node for which a handle is created. If $node is not specified, the behavior is identical to calling the function with the context item "(.)" as an argument. If the context item is not a node, an error is raised [err:FODC0001].