Skip to main content
summaryrefslogtreecommitdiffstats
blob: b3352e259b34fd4c44e37f5dbd2a43f2846a986c (plain) (blame)
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
83
84
85
86
87
88
89
90
91
92
93
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="IBM Software Development Platform">
<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css"/>
<TITLE>sort XPath function</TITLE>
</HEAD>
<BODY>
<TABLE border="0" cellpadding="0" cellspacing="1" width="100%">
	<TBODY>
		<TR>
			<TH align="left"><P>sort()</P></TH>
			<TH align="right"><A href="overview.html">Additional XPath Functions</A></TH>
		</TR>
	</TBODY>
</TABLE>
<HR>
<H2>sort</H2>
<P>Sort a node set by the specified sort keys.</P>
<HR>
<TABLE border="0" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Function Summary<BR>&nbsp;</TH></TR>
		<TR>
			<TD width="20%" valign="top">minimal arguments</TD>
			<TD><SPAN style="font-family: monospace" valign="top">
			NodeSet sort (XPath expression, String sortKey)<BR>&nbsp;<BR>
			</SPAN></TD>
		</TR>
		<TR>
			<TD width="20%" valign="top">all arguments</TD>
			<TD><SPAN style="font-family: monospace" valign="top">
			NodeSet sort (XPath expression, String sortKey, String sortKey2, ...)<BR>&nbsp;<BR>
			</SPAN></TD>
		</TR>
	</TBODY>
</TABLE>
<HR>
<TABLE border="0" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Required Arguments<BR>&nbsp;</TH>
        </TR>
		<TR>
			<TD width="20%" valign="top"><B>XPath expression</B></TD>
			<TD>an XPath expression identifying the nodes to sort</TD>
		</TR>
		<TR>
			<TD width="20%" valign="top"><B>String sortKey</B></TD>
			<TD>a quoted String containing an XPath expression for a sort key.
			The XPath expression is evaluated relative to each node in the node set being sorted.
			Optionally, the string my be suffixed with ::ascending or ::descending to
			indicate sort direction. The default sort direction is ascending.</TD>
		</TR>
	</TBODY>
</TABLE>
<HR>
<TABLE border="0" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Optional arguments<BR>&nbsp;</TH>
		</TR>
		<TR>
			<TD width="20%" valign="top"><B>String sortKey<i>N</i></B></TD>
			<TD>a secondary sort key should previous keys have resulted in equality.
			Format rules are as with sorkKey.</TD>
		</TR>
	</TBODY>
</TABLE>
<HR>
<TABLE border="0" width="100%">
	<TBODY>
		<TR>
			<TH colspan="2" align="left">Example<BR>&nbsp;</TH></TR>
		<TR>
			<TD colspan="2"><SPAN style="font-family: monospace">
<!-- Begin sort example -->
			<B>sort</B>(/phonebook/entry, '@lastName')<br>
			<P>returns a node set of phone book entries sorted by lastName</P>
			<B>sort</B>(/phonebook/entry, 'substring(@lastName, 1, 1)::descending', @firstName::ascending)<br>
			<P>returns a node set of phone book entries sorted in reverse order by the first letter of lastName
			and, within each letter, alphabetically by firstName</P>
<!-- End sort example -->
</SPAN></TD>
		</TR>
	</TBODY>
</TABLE>
<P><BR>
<FONT color="navy" size="-2">&copy; Copyright IBM Corporation 2000,
2008. All Rights Reserved.</FONT></P></P></BODY>
</HTML>

Back to the top