Design

Back Next

idref

The idref function in XQuery returns the sequence of element or attribute nodes with an

IDREF

value matching the value of one or more of the

values supplied in

$arg

fn:idref(arg, node)

The following table describes the argument for this command:

Argument	Required/Optional	Description
arg	Required	One or more IDREF values (space-separated tokens) to find referencing elements.
node	Optional	The node that provides context for resolving IDREFs. Defaults to root node of the context item if omitted.

Returns a sequence of element nodes whose IDREF attributes contain any of the specified

$arg

values.

Returns an empty sequence if no matching IDREFs are found.

The following table lists some sample values and return values:

SAMPLE FUNCTION	OUTPUT
fn:idref("item1", /root)	Elements that refer to the ID "item1" under /root .
fn:idref(("item1", "item2"))	Sequence of elements referring to "item1" or "item2".
fn:idref("nonexistent")	()
fn:idref("item1") (with context node omitted)	Elements referring to "item1" relative to context root node.