Difference between revisions of "Process Module"
Jump to navigation
Jump to search
Line 18: | Line 18: | ||
|- | |- | ||
|'''Errors''' | |'''Errors''' | ||
− | |'''[[#Errors| | + | |'''[[#Errors|BXPR9999]]''' is raised if the specified encoding does not exist or is not supported. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
Line 27: | Line 27: | ||
try { | try { | ||
proc:system('xyz') | proc:system('xyz') | ||
− | } catch | + | } catch bxerr:BXPR0002 { |
'Command not found.' | 'Command not found.' | ||
} | } | ||
Line 50: | Line 50: | ||
|- | |- | ||
|'''Errors''' | |'''Errors''' | ||
− | |'''[[#Errors| | + | |'''[[#Errors|BXPR9999]]''' is raised if the specified encoding does not exist or is not supported. |
|- | |- | ||
| '''Examples''' | | '''Examples''' | ||
Line 67: | Line 67: | ||
! width="95%"|Description | ! width="95%"|Description | ||
|- | |- | ||
− | |<code> | + | |<code>BXPR9999</code> |
|The specified encoding does not exist or is not supported. | |The specified encoding does not exist or is not supported. | ||
|} | |} |
Revision as of 01:44, 26 May 2012
This XQuery Module provides functions for executing system commands from XQuery.
Conventions
All functions in this module are assigned to the http://basex.org/modules/proc
namespace, which is statically bound to the proc
prefix.
All errors are assigned to the http://basex.org/errors
namespace, which is statically bound to the bxerr
prefix.
Functions
proc:system
Signatures | proc:system($cmd as xs:string) as xs:string proc:system($cmd as xs:string, $args as xs:string*) as xs:string proc:system($cmd as xs:string, $args as xs:string*, $encoding as xs:string) as xs:string
|
Summary | Executes the specified command in a separate process and returns the result as string. If the command results in an error, an XQuery exception will be thrown. Its error code will consist of the letters PROC and four digits with the command’s exit code.Additional command arguments may be specified via $args .The result can be explicitly converted to a specified $encoding . If no encoding is specified, the system’s default encoding is used.
|
Errors | BXPR9999 is raised if the specified encoding does not exist or is not supported. |
Examples |
try { proc:system('xyz') } catch bxerr:BXPR0002 { 'Command not found.' } |
proc:execute
Signatures | proc:execute($cmd as xs:string) as element(result) proc:execute($cmd as xs:string, $args as xs:string*) as element(result) proc:execute($cmd as xs:string, $args as xs:string*, $encoding as xs:string) as element(result)
|
Summary | Executes the specified command in a separate process and returns the result as element. Additional command arguments may be specified via $args .The result can be explicitly converted to a specified $encoding . If no encoding is specified, the system’s default encoding is used.A result has the following structure: <result> <output>...result...</output> <error/> <code>0</code> </result> |
Errors | BXPR9999 is raised if the specified encoding does not exist or is not supported. |
Examples |
|
Changelog
The module was introduced with Version 7.2.2.
Errors
Code | Description |
---|---|
BXPR9999
|
The specified encoding does not exist or is not supported. |