1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="xpf_current">
<refmeta>
<refentrytitle>current</refentrytitle>
<refmiscinfo>XPATH</refmiscinfo>
</refmeta>
<refnamediv>
<refname>current</refname>
<refpurpose>Returns a node-set that has the current node as its only member.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="xpf_syn_current">
<funcprototype id="xpf_proto_current">
<funcdef>node-set <function>current</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="xpf_desc_current"><title>Description</title>
<para>
The function returns a node-set that has the current node as its only member.
For an outermost expression (an expression not occurring within another expression),
the current node is always the same as the context node. For an expression
occurring within another expression, e.g. within predicate in some path,
the current node is the same as the context node of the first step in the path.
</para>
<para>
Please refer XSL standard before the first use of this function,
to understand exact difference between "current" and "context" node.
</para>
<para>
XSLT 1.0 states that it is an error to use the current() function in a XSL "pattern",
e.g. in "match" attribute of <xsl:key> element, because patterns
have no value assigned for current node assigned processing.
Instead of reporting the error, Virtuoso's XSLT processor uses context node
if current node is not set.
</para>
</refsect1>
<refsect1 id="xpf_ret_current"><title>Return Types</title><para>Node-set that has exactly one member.</para></refsect1>
<refsect1 id="xpf_examples_current"><title>Examples</title>
<example id="xpf_ex_current"><title>Function current() in top-level expression.</title>
<para>These two elements produce the same result:</para>
<screen>
<xsl:value-of select="current()"/>
<xsl:value-of select="."/>
</screen>
</example>
<example id="xpf_ex_current"><title>Function current() inside the path.</title>
<para>
For current node, which is equal to context node of whole <xsl:apply-templates> key,
try to find such item of glossary in the document, that the name of item is equal
to "ref" attribute of current node.
</para>
<screen>
<xsl:apply-templates select="//glossary/item[@name=current()/@ref]"/>
</screen>
</example>
</refsect1>
</refentry>
|
