Utility Module - Revision history

CG at 10:46, 6 May 2024

2024-05-06T10:46:26Z

CG at 12:36, 5 December 2023

2023-12-05T12:36:07Z

CG: Text replacement - "" to ""

2023-12-01T16:34:33Z

Text replacement - "</syntaxhighlight>" to "</pre>"

CG: Text replacement - "" to "

2023-12-01T16:34:23Z

Text replacement - "<syntaxhighlight lang="xquery">" to "<pre lang='xquery'>"

CG at 11:15, 23 November 2023

2023-11-23T11:15:05Z

CG at 15:37, 21 November 2023

2023-11-21T15:37:02Z

CG at 15:36, 21 November 2023

2023-11-21T15:36:55Z

CG at 15:36, 21 November 2023

2023-11-21T15:36:29Z

CG at 10:59, 26 October 2023

2023-10-26T10:59:47Z

CG at 10:58, 26 October 2023

2023-10-26T10:58:43Z

@@ Line 131: / Line 131: @@
 |- valign="top"
 | '''Summary'''
-|Returns nodes in ''distinct document order'': duplicate nodes will be removed, and the remaining nodes will be returned in [https://www.w3.org/TR/xquery-31/#dt-document-order document order]. As results of path expressions are brought distinct document order before they are returned, the function is equivalent to:
+|Returns nodes in ''distinct document order'': duplicate nodes will be removed, and the remaining nodes will be returned in [https://www.w3.org/TR/xquery-31/#dt-document-order document order]. As results of path expressions are brought into distinct document order before they are returned, the function is equivalent to:
 <pre lang='xquery'>
 $nodes/self::node()
@@ Line 149: / Line 149: @@
 |Returns the document nodes of the specified {{Code|$nodes}}. The path expression <code>/abc</code> is internally represented as <code>util:root(.)/abc</code>. Equivalent to:
 <pre lang='xquery'>
-$nodes ! /
+util:ddo($x ! /)
 </pre>
 |}

@@ Line 33: / Line 33: @@
 |- valign="top"
 | {{Code|util:map-entries}}
-| [https://qt4cg.org/specifications/xpath-functions-40/Overview.html#func-map-pairs <code>map:pairs</code>]
+| [https://qt4cg.org/specifications/xpath-functions-40/Overview.html#func-map-entries <code>map:entries</code>]
 |- valign="top"
 | {{Code|util:map-values}}

@@ Line 89: / Line 89: @@
 let $count := count($sequence)
 return $count >= $min and $count <= $max
-</syntaxhighlight>
+</pre>
 |- valign="top"
 | '''Examples'''
@@ Line 112: / Line 112: @@
 <pre lang='xquery'>
 subsequence($sequence, $first, $last - $first + 1)
-</syntaxhighlight>
+</pre>
 |- valign="top"
 | '''Examples'''
@@ Line 134: / Line 134: @@
 <pre lang='xquery'>
 $nodes/self::node()
-</syntaxhighlight>
+</pre>
 |}
@@ Line 150: / Line 150: @@
 <pre lang='xquery'>
 $nodes ! /
-</syntaxhighlight>
+</pre>
 |}
@@ Line 174: / Line 174: @@
 (: yields :)
 <xml name='value'><child/></xml>
-</syntaxhighlight>
+</pre>
 * Remove all default namespaces:
 <pre lang='xquery'>
 <xml xmlns='uri1'><child xmlns='uri2'/></xml>
 => util:strip-namespaces('')
-</syntaxhighlight>
+</pre>
 |}

@@ Line 86: / Line 86: @@
 | '''Summary'''
 |Checks if the specified {{Code|$sequence}} has at least {{Code|$min}} and, optionally, at most {{Code|$max}} items. Equivalent to:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 let $count := count($sequence)
 return $count >= $min and $count <= $max
@@ Line 110: / Line 110: @@
 | '''Summary'''
 |Returns items from {{Code|$sequence}}, starting at position {{Code|$first}} and ending at {{Code|$last}}. Equivalent to:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 subsequence($sequence, $first, $last - $first + 1)
 </syntaxhighlight>
@@ Line 132: / Line 132: @@
 | '''Summary'''
 |Returns nodes in ''distinct document order'': duplicate nodes will be removed, and the remaining nodes will be returned in [https://www.w3.org/TR/xquery-31/#dt-document-order document order]. As results of path expressions are brought distinct document order before they are returned, the function is equivalent to:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 $nodes/self::node()
 </syntaxhighlight>
@@ Line 148: / Line 148: @@
 | '''Summary'''
 |Returns the document nodes of the specified {{Code|$nodes}}. The path expression <code>/abc</code> is internally represented as <code>util:root(.)/abc</code>. Equivalent to:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 $nodes ! /
 </syntaxhighlight>
@@ Line 169: / Line 169: @@
+|
 * Remove all namespaces from an element and its descendants:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 util:strip-namespaces(<xml xmlns='uri' xmlns:prefix='uri2' prefix:name='value'><prefix:child/></xml>)
@@ Line 176: / Line 176: @@
 </syntaxhighlight>
 * Remove all default namespaces:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 <xml xmlns='uri1'><child xmlns='uri2'/></xml>
 => util:strip-namespaces('')

@@ Line 19: / Line 19: @@
 | {{Code|util:duplicates}}
 | [https://qt4cg.org/specifications/xpath-functions-40/Overview.html#func-duplicate-values <code>fn:duplicate-values</code>]
 |- valign="top"
 | {{Code|util:init}}
@@ Line 52: / Line 49: @@
 All functions and errors in this module and errors are assigned to the <code><nowiki>http://basex.org/modules/util</nowiki></code> namespace, which is statically bound to the {{Code|util}} prefix.<br/>
-=Range Conditions=
+=Conditions and Ranges=
 ==util:count-within==
@@ Line 183: / Line 202: @@
 ;Version 9.5
-* Added: {{Function||util:intersperse}}, {{Function||util:within}}, {{Function||util:duplicates}}, {{Function||util:array-members}}, {{Function||util:array-values}}, {{Function||util:map-entries}}, {{Function||util:map-values}}
+* Added: {{Code|util:intersperse}}, {{Code|util:within}}, {{Code|util:duplicates}}, {{Code|util:array-members}}, {{Code|util:array-values}}, {{Code|util:map-entries}}, {{Code|util:map-values}}
-* Updated: {{Function||util:replicate}}: Third argument added.
+* Updated: {{Code|util:replicate}}: Third argument added.
 ;Version 9.4
@@ Line 193: / Line 212: @@
 ;Version 9.2
-* Added: {{Function||util:chars}}, {{Function||util:init}}
+* Added: {{Code|util:chars}}, {{Code|util:init}}
-* Updated: {{Function||util:item}}, {{Function||util:last}}, {{Function||util:range}} renamed (before: {{Code|util:item-at}}, {{Code|util:item-range}}, {{Code|util:last-from}})
+* Updated: {{Code|util:item}}, {{Code|util:last}}, {{Function||util:range}} renamed (before: {{Code|util:item-at}}, {{Code|util:item-range}}, {{Code|util:last-from}})
 ;Version 9.1
-* Added: {{Function||util:if}}, {{Function||util:or}}
+* Added: {{Function||util:if}}, {{Code|util:or}}
 ;Version 9.0
-* Added: {{Function||util:replicate}}
+* Added: {{Code|util:replicate}}
 The Module was introduced with Version 8.5.

@@ Line 1: / Line 1: @@
 This [[Module Library|XQuery Module]] contains some utility and helper functions.
-With {{Announce|Version 11}}, many functions have been removed in favor or new features of XQuery 4:
+With {{Announce|Version 11}}, many functions have been removed in favor of new features of XQuery 4:
 {|

@@ Line 1: / Line 1: @@
-This [[Module Library|XQuery Module]] contains some utility and helper functions. With {{Announce|Version 11}}, many functions have been removed as they are now part of the official specification:
+This [[Module Library|XQuery Module]] contains some utility and helper functions.
 {|
@@ Line 44: / Line 46: @@
 All functions and errors in this module and errors are assigned to the <code><nowiki>http://basex.org/modules/util</nowiki></code> namespace, which is statically bound to the {{Code|util}} prefix.<br/>
-=Conditions=
+=Range Conditions=
 ==util:count-within==
@@ Line 69: / Line 71: @@
 * <code>util:count-within((1 to 1000000000)[. < 10], 3, 6)</code> returns {{Code|true}}.
 |}
 ==util:range==

← Older revision		Revision as of 10:58, 26 October 2023
Line 1:		Line 1:
−	This [[Module Library\|XQuery Module]] contains some utility and helper functions.	+	This [[Module Library\|XQuery Module]] contains some utility and helper functions. With {{Announce\|Version 11}}, many functions have been removed as they are now part of the official specification:
−
−	With {{Announce\|Version 11}}, many functions ~~of this module~~ have been removed as they are now part of the official specification:

	{\|		{\|