XQuery 3.0 - Revision history

CG: Text replacement - "syntaxhighlight" to "pre"

2023-12-01T16:38:39Z

Text replacement - "syntaxhighlight" to "pre"

CG: Text replacement - "" to ""

2023-12-01T16:34:24Z

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

CG: Text replacement - "" to "

2023-12-01T16:31:06Z

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

Show changes

CG: /* Expanded QNames */

2023-10-31T17:50:27Z

Expanded QNames

CG: /* Changelog */

2023-10-25T09:48:20Z

Changelog

CG: /* Functions */

2023-10-25T09:47:15Z

Functions

CG at 09:45, 25 October 2023

2023-10-25T09:45:47Z

CG: /* Try/Catch */

2023-07-13T15:16:27Z

Try/Catch

CG at 11:18, 15 May 2023

2023-05-15T11:18:42Z

CG: Text replacement - "db:pre(" to "db:get("

2022-07-20T11:33:22Z

Text replacement - "db:pre(" to "db:get("

@@ Line 41: / Line 41: @@
 '''Result:'''
-<syntaxhighlight lang="xml">
+<pre lang="xml">
 <challenge>4731</challenge>
 <na>12677</na>
@@ Line 56: / Line 56: @@
 '''Result:'''
-<syntaxhighlight lang="xml">
+<pre lang="xml">
 <challenge>
    <person id="person0">
@@ Line 86: / Line 86: @@
 '''Result:'''
-<syntaxhighlight lang="xml">
+<pre lang="xml">
 <persons country="USA">
    <name>John</name>

@@ Line 13: / Line 13: @@
 count $id
 return <country id='{ $id }' name='{ $name }'>{ $city/name }</country>
-</syntaxhighlight>
+</pre>
 ==group by==
@@ Line 35: / Line 35: @@
 order by $income
 return element { $income } { count($ppl) }
-</syntaxhighlight>
+</pre>
 This query is a rewrite of [https://www.ins.cwi.nl/projects/xmark/Assets/xmlquery.txt Query #20] contained in the [https://projects.cwi.nl/xmark/ XMark Benchmark Suite] to use <code>group by</code>.
@@ Line 46: / Line 46: @@
 <preferred>314</preferred>
 <standard>7778</standard>
-</syntaxhighlight>
+</pre>
 In contrast to the relational GROUP BY statement, the XQuery counterpart concatenates the values of all non-grouping variables that belong to a specific group. In the context of our example, all nodes in <code>//people/person</code> that belong to the <code>preferred</code> partition are concatenated in <code class="brush:xquery">$ppl</code> after grouping has finished. You can see this effect by changing the return statement to:
@@ Line 53: / Line 53: @@
 ...
 return element { $income } { $ppl }
-</syntaxhighlight>
+</pre>
 '''Result:'''
@@ Line 64: / Line 64: @@
      …
 </challenge>
-</syntaxhighlight>
+</pre>
 Moreover, a value can be assigned to the grouping variable. This is shown in the following example:
@@ Line 83: / Line 83: @@
    return element name { data($name) }
+}
-</syntaxhighlight>
+</pre>
 '''Result:'''
@@ Line 94: / Line 94: @@
    <name>Johann</name>
 </persons>
-</syntaxhighlight>
+</pre>
 ==count==
@@ Line 104: / Line 104: @@
 count $c
 return <number count="{ $c }" number="{ $n }"/>
-</syntaxhighlight>
+</pre>
 ==allowing empty==
@@ Line 113: / Line 113: @@
 for $n allowing empty in ()
 return 'empty? ' || empty($n)
-</syntaxhighlight>
+</pre>
 ==window==
@@ Line 124: / Line 124: @@
      only end at $e when $e - $s eq 2
 return <window>{ $w }</window>
-</syntaxhighlight>
+</pre>
 More information on window clauses, and all other enhancements, can be found in the [https://www.w3.org/TR/xquery-30/#id-windows specification].
@@ Line 139: / Line 139: @@
 <li>Declaring a new ''inline function'':
 <pre lang='xquery'>let $f := function($x, $y) { $x + $y }
-return $f(17, 25)</syntaxhighlight>
+return $f(17, 25)</pre>
 '''Result:''' <code>42</code>
 </li>
 <li>Getting the function item of an existing (built-in or user-defined) XQuery function. The arity (number of arguments) has to be specified as there can be more than one function with the same name:
 <pre lang='xquery'>let $f := math:pow#2
-return $f(5, 2)</syntaxhighlight>
+return $f(5, 2)</pre>
 '''Result:''' <code>25</code>
 </li>
@@ Line 152: / Line 152: @@
    $f('foo123'),
    $f('bar456')
-)</syntaxhighlight>
+)</pre>
 '''Result:''' <code>foo bar</code>
 </li>
@@ Line 170: / Line 170: @@
 for $i in 1 to 10
 return element node { $i }
-</syntaxhighlight>
+</pre>
 In contrast to path expressions, the results of the map operator will not be made duplicate-free and returned in document order.
@@ Line 187: / Line 187: @@
    'Error [' || $err:code || ']: ' || $err:description
+}
-</syntaxhighlight>
+</pre>
 '''Result:''' <code>Typing error: '+' operator: number expected, xs:string found.</code>
@@ Line 211: / Line 211: @@
    case "Peach" return "pink"
    default      return "unknown"
-</syntaxhighlight>
+</pre>
 '''Result:''' <code>red green pink</code>
@@ Line 229: / Line 229: @@
    default
       return "unknown"
-</syntaxhighlight>
+</pre>
 '''Result:''' <code>red red</code>
@@ Line 246: / Line 246: @@
 <pre lang='xquery'>
 element node { namespace pref { 'http://url.org/' } }
-</syntaxhighlight>
+</pre>
 =String Concatenations=
@@ Line 254: / Line 254: @@
 <pre lang='xquery'>
 'Hello' || ' ' || 'Universe'
-</syntaxhighlight>
+</pre>
 =External Variables=
@@ Line 263: / Line 263: @@
 declare variable $user external := "admin";
 "User:", $user
-</syntaxhighlight>
+</pre>
 =Serialization=
@@ Line 275: / Line 275: @@
 declare option output:method "xhtml";
 <html/>
-</syntaxhighlight>
+</pre>
 '''Result:''' <code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;&lt;html&gt;&lt;/html&gt;</code>
@@ Line 295: / Line 295: @@
 for $t in .//text()
 return string-length($t)
-</syntaxhighlight>
+</pre>
 '''Result:''' <code>5 5</code>
@@ Line 309: / Line 309: @@
 local:max(2, 3)
-</syntaxhighlight>
+</pre>
 =Functions=

@@ Line 234: / Line 234: @@
 =Expanded QNames=
-A ''QName'' can be prefixed with the letter "Q" and a namespace URI in the [http://www.jclark.com/xml/xmlns.htm Clark Notation].
+A ''QName'' can be prefixed with the letter {{Code|Q}}, the namespace URI wrapped in curly braces and the local name.
 '''Examples:'''

← Older revision		Revision as of 09:48, 25 October 2023
Line 322:		Line 322:

	=Changelog=		=Changelog=
−
−	~~;Version 8.4~~
−
−	* Added: %non-deterministic
−
−	~~;Version 8.0~~
−
−	* Added: %basex:inline, %basex:lazy

	;Version 7.7		;Version 7.7

@@ Line 315: / Line 315: @@
 The following functions have been added in the [https://www.w3.org/TR/xpath-functions-31/ XQuery 3.0 Functions and Operators] Specification:
-<code>analyze-string</code>* <code>available-environment-variables</code>, <code>element-with-id</code>, <code>environment-variable</code>, <code>filter</code>, <code>fold-left</code>, <code>fold-right</code>, <code>for-each</code>, <code>for-each-pair</code>, <code>format-date</code>, <code>format-dateTime</code>, <code>format-integer</code>, <code>format-number</code>, <code>format-time</code>, <code>function-arity</code>, <code>function-lookup</code>, <code>function-name</code>, <code>generate-id</code>, <code>has-children</code>, <code>head</code>, <code>innermost</code>, <code>outermost</code>, <code>parse-xml</code>, <code>parse-xml-fragment</code>, <code>path</code>, <code>serialize</code>, <code>tail</code>, <code>unparsed-text</code>, <code>unparsed-text-available</code>, <code>unparsed-text-lines</code>, <code>uri-collection</code>
+<code>analyze-string</code>, <code>available-environment-variables</code>, <code>element-with-id</code>, <code>environment-variable</code>, <code>filter</code>, <code>fold-left</code>, <code>fold-right</code>, <code>for-each</code>, <code>for-each-pair</code>, <code>format-date</code>, <code>format-dateTime</code>, <code>format-integer</code>, <code>format-number</code>, <code>format-time</code>, <code>function-arity</code>, <code>function-lookup</code>, <code>function-name</code>, <code>generate-id</code>, <code>has-children</code>, <code>head</code>, <code>innermost</code>, <code>outermost</code>, <code>parse-xml</code>, <code>parse-xml-fragment</code>, <code>path</code>, <code>serialize</code>, <code>tail</code>, <code>unparsed-text</code>, <code>unparsed-text-available</code>, <code>unparsed-text-lines</code>, <code>uri-collection</code>
 New signatures have been added for the following functions:

@@ Line 267: / Line 267: @@
 =Serialization=
-[[Serialization|Serialization ]]parameters can be defined within XQuery expressions. Parameters are placed in the query prolog and need to be specified as option declarations, using the <code>output</code> prefix.
+[[Serialization]] parameters can be defined within XQuery expressions. Parameters are placed in the query prolog and need to be specified as option declarations, using the <code>output</code> prefix.
 '''Example:'''

@@ Line 198: / Line 198: @@
 * {{Code|$err:line-number}}: line number where the error occurred
 * {{Code|$err:column-number}}: column number where the error occurred
 =Switch=

@@ Line 121: / Line 121: @@
 <syntaxhighlight lang="xquery">
 for tumbling window $w in (2, 4, 6, 8, 10, 12, 14)
-     start at $s when fn:true()
+     start at $s when true()
      only end at $e when $e - $s eq 2
 return <window>{ $w }</window>
@@ Line 148: / Line 148: @@
 </li>
 <li>''Partially applying'' another function or function item. This is done by supplying only some of the required arguments, writing the placeholder <code>?</code> in the positions of the arguments left out. The produced function item has one argument for every placeholder.
-<syntaxhighlight lang="xquery">let $f := fn:substring(?, 1, 3)
+<syntaxhighlight lang="xquery">let $f := substring(?, 1, 3)
 return (
    $f('foo123'),
@@ Line 157: / Line 157: @@
 </ul>
-Function items can also be passed as arguments to and returned as results from functions. These so-called [[Higher-Order Functions]] like <code>fn:map</code> and <code>fn:fold-left</code> are discussed in more depth on their own Wiki page.
+Function items can also be passed as arguments to and returned as results from functions. These so-called [[Higher-Order Functions]] like <code>for-each</code> and <code>fold-left</code> are discussed in more depth on their own Wiki page.
 =Simple Map Operator=
@@ Line 251: / Line 251: @@
 =String Concatenations=
-Two vertical bars <code>||</code> (also named ''pipe characters'') can be used to concatenate strings. This operator is a shortcut for the {{Code|fn:concat()}} function.
+Two vertical bars <code>||</code> (also named ''pipe characters'') can be used to concatenate strings. This operator is a shortcut for the {{Code|concat()}} function.
 <syntaxhighlight lang="xquery">
@@ Line 316: / Line 316: @@
 The following functions have been added in the [https://www.w3.org/TR/xpath-functions-31/ XQuery 3.0 Functions and Operators] Specification:
-<code>fn:analyze-string</code>* <code>fn:available-environment-variables</code>, <code>fn:element-with-id</code>, <code>fn:environment-variable</code>, <code>fn:filter</code>, <code>fn:fold-left</code>, <code>fn:fold-right</code>, <code>fn:for-each</code>, <code>fn:for-each-pair</code>, <code>fn:format-date</code>, <code>fn:format-dateTime</code>, <code>fn:format-integer</code>, <code>fn:format-number</code>, <code>fn:format-time</code>, <code>fn:function-arity</code>, <code>fn:function-lookup</code>, <code>fn:function-name</code>, <code>fn:generate-id</code>, <code>fn:has-children</code>, <code>fn:head</code>, <code>fn:innermost</code>, <code>fn:outermost</code>, <code>fn:parse-xml</code>, <code>fn:parse-xml-fragment</code>, <code>fn:path</code>, <code>fn:serialize</code>, <code>fn:tail</code>, <code>fn:unparsed-text</code>, <code>fn:unparsed-text-available</code>, <code>fn:unparsed-text-lines</code>, <code>fn:uri-collection</code>
+<code>analyze-string</code>* <code>available-environment-variables</code>, <code>element-with-id</code>, <code>environment-variable</code>, <code>filter</code>, <code>fold-left</code>, <code>fold-right</code>, <code>for-each</code>, <code>for-each-pair</code>, <code>format-date</code>, <code>format-dateTime</code>, <code>format-integer</code>, <code>format-number</code>, <code>format-time</code>, <code>function-arity</code>, <code>function-lookup</code>, <code>function-name</code>, <code>generate-id</code>, <code>has-children</code>, <code>head</code>, <code>innermost</code>, <code>outermost</code>, <code>parse-xml</code>, <code>parse-xml-fragment</code>, <code>path</code>, <code>serialize</code>, <code>tail</code>, <code>unparsed-text</code>, <code>unparsed-text-available</code>, <code>unparsed-text-lines</code>, <code>uri-collection</code>
 New signatures have been added for the following functions:
-<code>fn:document-uri</code>, <code>fn:string-join</code>, <code>fn:node-name</code>, <code>fn:round</code>, <code>fn:data</code>
+<code>document-uri</code>, <code>string-join</code>, <code>node-name</code>, <code>round</code>, <code>data</code>
 =Changelog=

@@ Line 7: / Line 7: @@
 '''Example:'''
 <syntaxhighlight lang="xquery">
-for $country in db:pre('factbook')//country
+for $country in db:get('factbook')//country
 where $country/@population > 100000000
 for $city in $country//city[population > 1000000]