Process Module - Revision history

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

2023-12-01T16:38:17Z

Text replacement - "syntaxhighlight" to "pre"

CG: Text replacement - "" to ""

2023-12-01T16:31:31Z

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

CG: Text replacement - "" to "

2023-12-01T16:30:09Z

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

CG at 14:31, 9 March 2023

2023-03-09T14:31:28Z

CG at 14:03, 9 March 2023

2023-03-09T14:03:24Z

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

2023-03-09T13:07:48Z

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

CG at 11:07, 9 March 2023

2023-03-09T11:07:33Z

CG at 12:19, 20 July 2022

2022-07-20T12:19:17Z

CG: Text replacement - "\[\[#([^]:]+:[^|]+)\|([^]:]+:[^|]+)\]\]" to "{{Function||$1}}"

2022-07-18T17:50:18Z

Text replacement - "\[\[#([^]:]+:[^|]+)\|([^]:]+:[^|]+)\]\]" to "{{Function||$1}}"

CG at 14:19, 27 February 2020

2020-02-27T14:19:19Z

@@ Line 65: / Line 65: @@
 * Instead of the {{Code|proc:code....}} error, the error message will be assigned to the returned element (no process code will be returned).
 The result has the following structure:
-<syntaxhighlight lang="xml">
+<pre lang="xml">
 <result>
    <output>...output...</output>

@@ Line 37: / Line 37: @@
    map { 'input': 'A B' || out:nl() || 'C' }
+)
-</syntaxhighlight>
+</pre>
 * The following example returns “Command not found” (unless {{Code|xyz}} is a valid command on the system):
 <pre lang='xquery'>
@@ Line 45: / Line 45: @@
    'Command not found: ' || $err:description
+}
-</syntaxhighlight>
+</pre>
 |}
@@ Line 71: / Line 71: @@
    <code>...process code...</code>
 </result>
-</syntaxhighlight>
+</pre>
 |- valign="top"
 |'''Errors'''

@@ Line 32: / Line 32: @@
 * {{Code|proc:system('date')}} returns the current date on a Linux system.
 * Analyses the given input and counts the number of lines, words and characters (provided that {{Code|wc}} is available on the system):
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 proc:system(
    'wc', (),
@@ Line 39: / Line 39: @@
 </syntaxhighlight>
 * The following example returns “Command not found” (unless {{Code|xyz}} is a valid command on the system):
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 try {
    proc:system('xyz')

@@ Line 13: / Line 13: @@
 | width='120' | '''Signature'''
 |<pre>proc:system(
-   $cmd      as xs:string,
+   $command    as xs:string,
-   $args     as xs:string*  := (),
+   $arguments  as xs:string*  := (),
-   $options  as map(*)      := ()
+   $options    as map(*)?     := map { }
 ) as xs:string</pre>
 |- valign="top"
 | '''Summary'''
-|Executes the specified command in a separate process and returns the result as string. {{Code|$cmd}} is the name of the command, arguments to the command may be specified via {{Code|$args}}. The {{Code|$options}} parameter contains process options:
+|Executes a {{Code|$command}} with the specified {{Code|$arguments}} in a separate process and returns the result as a string. The {{Code|$options}} parameter contains process options:
 * {{Code|encoding}}: convert result to the specified encoding. If no encoding is supplied, the system’s default encoding is used.
 * {{Code|timeout}}: abort process execution after the specified number of seconds.
@@ Line 54: / Line 54: @@
 | width='120' | '''Signature'''
 |<pre>proc:execute(
-   $cmd      as xs:string,
+   $command    as xs:string,
-   $args     as xs:string*  := (),
+   $arguments  as xs:string*  := (),
-   $options  as map(*)      := ()
+   $options    as map(*)?     := map { }
 ) as element(result)</pre>
 |- valign="top"
 | '''Summary'''
-|Executes the specified command in a separate process and returns the result as element:
+|Executes a {{Code|$command}} with the specified {{Code|$arguments}} in a separate process and returns the result as an element:
 * The same {{Code|$options}} are allowed as for {{Function||proc:system}}.
 * Instead of the {{Code|proc:error}} error, the error message and process code will be assigned to the returned elements.
@@ Line 89: / Line 88: @@
 | width='120' | '''Signature'''
 |<pre>proc:fork(
-   $cmd        as xs:string,
+   $command    as xs:string,
-   $args       as xs:string*  := (),
+   $arguments  as xs:string*  := (),
-   $options    as map(*)      := ()
+   $options    as map(*)?     := map { }
 ) as element(result)</pre>
 |- valign="top"
 | '''Summary'''
-|Executes the specified command and ignores the result. {{Code|$cmd}} is the name of the command, and arguments to the command may be specified via {{Code|$args}}. The same {{Code|$options}} are allowed as for {{Function||proc:system}} (but the encoding will be ignored).
+|Executes a {{Code|$command}} with the specified {{Code|$arguments}} in a separate process and ignores the result. The same {{Code|$options}} are allowed as for {{Function||proc:system}} with the encoding being ignored.
 |- valign="top"
 |'''Errors'''

@@ Line 13: / Line 13: @@
 | width='120' | '''Signature'''
 |<pre>proc:system(
-   $cmd        as xs:string
+   $cmd      as xs:string,
-   $args       as xs:string*     := ()
+   $args     as xs:string*  := (),
-   $options    as map(xs:string  := ()
+   $options  as map(*)      := ()
 ) as xs:string</pre>
 |- valign="top"
@@ Line 55: / Line 54: @@
 | width='120' | '''Signature'''
 |<pre>proc:execute(
-   $cmd        as xs:string
+   $cmd      as xs:string,
-   $args       as xs:string*     := ()
+   $args     as xs:string*  := (),
-   $options    as map(xs:string  := ()
+   $options  as map(*)      := ()
 ) as element(result)</pre>
 |- valign="top"
@@ Line 91: / Line 89: @@
 | width='120' | '''Signature'''
 |<pre>proc:fork(
-   $cmd        as xs:string
+   $cmd        as xs:string,
-   $args       as xs:string*     := ()
+   $args       as xs:string*  := (),
-   $options    as map(xs:string  := ()
+   $options    as map(*)      := ()
 ) as element(result)</pre>
 |- valign="top"

@@ Line 11: / Line 11: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>proc:system(
    $cmd        as xs:string
@@ Line 53: / Line 53: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>proc:execute(
    $cmd        as xs:string
@@ Line 89: / Line 89: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>proc:fork(
    $cmd        as xs:string
@@ Line 112: / Line 112: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>proc:property(
    $name  as xs:string
@@ Line 130: / Line 130: @@
 {| width='100%'
 |- valign="top"
-| width='120' | '''Signatures'''
+| width='120' | '''Signature'''
 |<pre>proc:property-names() as xs:string*</pre>
 |- valign="top"

@@ Line 54: / Line 54: @@
 |Executes the specified command in a separate process and returns the result as element:
 * {{Code|$cmd}} is the name of the command, and arguments to the command may be specified via {{Code|$args}}.
-* The same {{Code|$options}} are allowed as for [[#proc:system|proc:system]].
+* The same {{Code|$options}} are allowed as for {{Function||proc:system}}.
 * Instead of the {{Code|proc:error}} error, the error message and process code will be assigned to the returned elements.
 * Instead of the {{Code|proc:code....}} error, the error message will be assigned to the returned element (no process code will be returned).
@@ Line 83: / Line 83: @@
 |-
 | '''Summary'''
-|Executes the specified command and ignores the result. {{Code|$cmd}} is the name of the command, and arguments to the command may be specified via {{Code|$args}}. The same {{Code|$options}} are allowed as for [[#proc:system|proc:system]] (but the encoding will be ignored).
+|Executes the specified command and ignores the result. {{Code|$cmd}} is the name of the command, and arguments to the command may be specified via {{Code|$args}}. The same {{Code|$options}} are allowed as for {{Function||proc:system}} (but the encoding will be ignored).
 |-
 |'''Errors'''
@@ Line 147: / Line 147: @@
 ;Version 9.0
-* Added: [[#proc:fork|proc:fork]]
+* Added: {{Function||proc:fork}}
 * Updated: error codes; errors now use the module namespace
 * Updated: new {{Code|input}} option; revised error handling
@@ Line 153: / Line 153: @@
 ;Version 8.6
-* Updated: [[#proc:system|proc:system]], [[#proc:exec|proc:exec]]: {{Code|encoding}} option moved to options argument, {{Code|timeout}} and {{Code|dir}} options added.
+* Updated: {{Function||proc:system}}, {{Function||proc:exec}}: {{Code|encoding}} option moved to options argument, {{Code|timeout}} and {{Code|dir}} options added.
 ;Version 8.3
-* Added: [[#proc:property|proc:property]], [[#proc:property-names|proc:property-names]].
+* Added: {{Function||proc:property}}, {{Function||proc:property-names}}.
 The module was introduced with Version 7.3.