Update Module - Revision history

CG: Text replacement - "" to "

2023-12-01T16:36:28Z

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

CG: Text replacement - "" to ""

2023-12-01T16:33:58Z

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

CG at 12:52, 31 October 2023

2023-10-31T12:52:55Z

Andy Bunce: add return types for function args in signatures

2023-07-03T13:13:22Z

add return types for function args in signatures

Andy Bunce: update:for-each sig add comma

2023-07-03T11:29:48Z

update:for-each sig add comma

CG at 15:15, 9 March 2023

2023-03-09T15:15:14Z

CG at 15:14, 9 March 2023

2023-03-09T15:14:37Z

CG at 14:16, 9 March 2023

2023-03-09T14:16:39Z

CG: Text replacement - "'''Signatures'''" to "'''Signature'''"

2023-03-09T13:04:39Z

Text replacement - "'''Signatures'''" to "'''Signature'''"

CG at 11:08, 9 March 2023

2023-03-09T11:08:57Z

@@ Line 25: / Line 25: @@
+|
 * Creates a new database with an initial document and adds a document to an existing database.
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 declare %updating function local:update(
    $database  as xs:string,
@@ Line 54: / Line 54: @@
+|
 * Creates two databases:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 let $names := ('db1', 'db2')
 return update:for-each($names, db:create#1)
@@ Line 77: / Line 77: @@
+|
 * Renames nodes in an XML snippets:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 copy $xml := <xml><a/><b/></xml>
 modify update:for-each-pair(
@@ Line 106: / Line 106: @@
+|
 * Inserts attributes into a document:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 copy $doc := <xml/>
 modify update:map-for-each(

@@ Line 35: / Line 35: @@
 local:update('new-db', 'doc.xml', db:create#2),
 local:update('existing-db', 'doc.xml', db:add#2)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 57: / Line 57: @@
 let $names := ('db1', 'db2')
 return update:for-each($names, db:create#1)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 88: / Line 88: @@
+)
 return $xml
-</syntaxhighlight>
+</pre>
 |}
@@ Line 117: / Line 117: @@
+   }
+)
-return $doc</syntaxhighlight>
+return $doc</pre>
 |}

@@ Line 149: / Line 149: @@
 |- valign="top"
 | '''Summary'''
-|Returns the items that have been cached by {{Function||update:output}}. The output cache can optionally be {{Code|$reset}}. The function can be used to check which items will eventually be returned as the result of an updating function.<br/>This function is ''non-deterministic'': It will return different results before and after items have been cached. The function can be useful for writing [[Unit Module|unit tests]].
+|Returns the items that have been cached by {{Function||update:output}}. The output cache can optionally be {{Code|$reset}}. The function can be used to check which items will eventually be returned as the result of an updating function.<br/>This function is ''nondeterministic'': It will return different results before and after items have been cached. The function can be useful for writing [[Unit Module|unit tests]].
 |}

@@ Line 45: / Line 45: @@
 |<pre>update:for-each(
    $input   as item()*,
-   $action  as function(item())
+   $action  as function(item()) as item()*
 ) as empty-sequence()</pre>
 |- valign="top"
@@ Line 68: / Line 68: @@
    $input1  as item()*,
    $input2  as item()*,
-   $action  as function(item())
+   $action  as function(item()) as item()*
 ) as empty-sequence()</pre>
 |- valign="top"

@@ Line 44: / Line 44: @@
 | width='120' | '''Signature'''
 |<pre>update:for-each(
-   $input   as item()*
+   $input   as item()*,
    $action  as function(item())
 ) as empty-sequence()</pre>

@@ Line 145: / Line 145: @@
 | width='120' | '''Signature'''
 |<pre>update:cache(
-   $reset  as xs:boolean  := ()
+   $reset  as xs:boolean?  := false()
 ) as item()*</pre>
 |- valign="top"

@@ Line 15: / Line 15: @@
 | width='120' | '''Signature'''
 |<pre>update:apply(
-   $function   as function(*)
+   $function   as function(*),
    $arguments  as array(*)
 ) as empty-sequence()</pre>
@@ Line 44: / Line 44: @@
 | width='120' | '''Signature'''
 |<pre>update:for-each(
-   $seq       as item()*
+   $input   as item()*
-   $function  as function(item())
+   $action  as function(item())
 ) as empty-sequence()</pre>
 |- valign="top"
 | '''Summary'''
-|The updating variant of [[Higher-Order Functions#fn:for-each|fn:for-each]] applies the specified updating <code>$function</code> to every item of <code>$seq</code>.
+|The updating variant of [[Higher-Order Functions#fn:for-each|fn:for-each]] applies the specified updating <code>$action</code> to every item of <code>$input</code>.
 |- valign="top"
 | '''Examples'''
@@ Line 66: / Line 66: @@
 | width='120' | '''Signature'''
 |<pre>update:for-each-pair(
-   $seq1      as item()*
+   $input1  as item()*,
-   $function  as function(item())
+   $input2  as item()*,
 ) as empty-sequence()</pre>
 |- valign="top"
 | '''Summary'''
-|The updating variant of [[Higher-Order Functions#fn:for-each-pair|fn:for-each-pair]] applies the specified updating <code>$function</code> to the successive pairs of items of <code>$seq1</code> and <code>$seq2</code>. Evaluation is stopped if one sequence yields no more items.
+|The updating variant of [[Higher-Order Functions#fn:for-each-pair|fn:for-each-pair]] applies the specified updating <code>$action</code> to the successive pairs of items of <code>$input1</code> and <code>$input2</code>. Evaluation is stopped if one sequence yields no more items.
 |- valign="top"
 | '''Examples'''
@@ Line 95: / Line 96: @@
 | width='120' | '''Signature'''
 |<pre>update:map-for-each(
-   $map       as map(*)
+   $map     as map(*),
-   $function  as function(xs:anyAtomicType
+   $action  as function(xs:anyAtomicType, item()*) as item()*
 ) as item()*</pre>
 |- valign="top"
 | '''Summary'''
-|The updating variant of {{Function|Map|map:for-each}} applies the specified {{Code|$function}} to every key/value pair of the supplied {{Code|$map}} and returns the results as a sequence.
+|The updating variant of {{Function|Map|map:for-each}} applies the specified {{Code|$action}} to every key/value pair of the supplied {{Code|$map}} and returns the results as a sequence.
 |- valign="top"
 | '''Examples'''
@@ Line 128: / Line 128: @@
 | width='120' | '''Signature'''
 |<pre>update:output(
-   $items  as item()*
+   $input  as item()*
 ) as empty-sequence()</pre>
 |- valign="top"
 | '''Summary'''
-|This function can be used if {{Option|MIXUPDATES}} is not enabled, and if values need to returned within an updating expression: The supplied {{Code|$items}} will be cached and returned at the very end, i.e., after all updates on the ''pending update list'' have been processed. If one of the supplied items is affected by an update, a copy will be created and cached instead.
+|This function can be used if {{Option|MIXUPDATES}} is not enabled, and if values need to be returned within an updating expression: The supplied {{Code|$input}} will be cached and returned at the very end, i.e., after all updates on the ''pending update list'' have been processed. If one of the supplied items is affected by an update, a copy will be created and cached instead.
 |- valign="top"
 | '''Examples'''