jrunscript(1)

名前
jrunscript - コマンド行スクリプトシェル

形式

jrunscript [ options ] [ arguments... ]

パラメータ

options
    オプションを使用する場合、コマンド名の直後に記述してください。

arguments
    引数を使用する場合、オプションまたはコマンド名の直後に記述してください。

説明

jrunscript はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り - 評価 - 出力) モードとバッチ (-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。

注: このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。

オプション

-classpath path
    スクリプトからのアクセス対象となるユーザの .class ファイルの検索場所を指定します。

-cp path
    -classpath path と同義です。

-Dname=value
    Java のシステムプロパティを設定します。

-J<flag>
    jrunscript が実行されている Java 仮想マシンに、直接 <flag> を渡します。

-l language
    指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、-cp、-classpath のいずれかのオプションを使用します。

-e script
    指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。

-encoding encoding
    スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。

-f script-file
    指定されたスクリプトファイルを評価します (バッチモード)。

-f -
    標準入力からスクリプトを読み取り、それを評価します (対話型モード)。

-help
    ヘルプメッセージを出力したあと、終了します。

-?  ヘルプメッセージを出力したあと、終了します。

-q  利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。

引数

[arguments...] が存在していて、かつ -e、-f のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ -e、-f のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、-e、-f がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。

例

インラインスクリプトの実行

    jrunscript -e "print('hello world')"
    jrunscript -e "cat('http://java.sun.com')"

指定された言語を使用し、指定されたスクリプトファイルを評価する

    jrunscript -l js -f test.js

対話型モード

    jrunscript
    js>print('hello world');
    hello world
    js>34 + 55
    89
    js> thread(function() { print('hello world'); }
    hello world
    js>

スクリプト引数を指定してスクリプトファイルを実行する

    jrunscript test.js arg1 arg2 arg3

test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。

関連項目

JavaScript が使用される場合、jrunscript は、最初のユーザ定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。