jrunscript-java-23 - Man Page
run a command-line script shell that supports interactive and batch modes
Synopsis
Note:
This tool is experimental and unsupported.
jrunscript
[options] [arguments]
- options
This represents the
jrunscript
command-line options that can be used. See Options for the jrunscript Command.- arguments
Arguments, when used, follow immediately after options or the command name. See Arguments.
Description
The jrunscript
command is a language-independent command-line script shell. The jrunscript
command supports both an interactive (read-eval-print) mode and a batch (-f
option) mode of script execution. By default, JavaScript is the language used, but the -l
option can be used to specify a different language. By using Java to scripting language communication, the jrunscript
command supports an exploratory programming style.
If JavaScript is used, then before it evaluates a user defined script, the jrunscript
command initializes certain built-in functions and objects, which are documented in the API Specification for jrunscript
JavaScript built-in functions.
Options for the Jrunscript Command
- -cp path or -classpath path
Indicates where any class files are that the script needs to access.
- -Dname=value
Sets a Java system property.
- -Jflag
Passes flag directly to the Java Virtual Machine where the
jrunscript
command is running.- -l language
Uses the specified scripting language. By default, JavaScript is used. To use other scripting languages, you must specify the corresponding script engine's JAR file with the
-cp
or-classpath
option.- -e script
Evaluates the specified script. This option can be used to run one-line scripts that are specified completely on the command line.
- -encoding encoding
Specifies the character encoding used to read script files.
- -f script-file
Evaluates the specified script file (batch mode).
- -f -
Enters interactive mode to read and evaluate a script from standard input.
- -help or -?
Displays a help message and exits.
- -q
Lists all script engines available and exits.
Arguments
If arguments are present and if no -e
or -f
option is used, then the first argument is the script file and the rest of the arguments, if any, are passed as script arguments. If arguments and the -e
or the -f
option are used, then all arguments are passed as script arguments. If arguments -e
and -f
are missing, then the interactive mode is used.
Example of Executing Inline Scripts
Example of Using Specified Language and Evaluate the Script File
Example of Interactive Mode
jrunscript js> print('Hello World\n'); Hello World js> 34 + 55 89.0 js> t = new java.lang.Thread(function() { print('Hello World\n'); }) Thread[Thread-0,5,main] js> t.start() js> Hello World js>
Run Script File with Script Arguments
In this example, the test.js
file is the script file. The arg1
, arg2
, and arg3
arguments are passed to the script. The script can access these arguments with an arguments array.
jrunscript test.js arg1 arg2 arg3