jrunscript(1)

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

    o   形式

    o   パラメータ

    o   説明

    o   オプション

    o   引数

    o   例

    o   関連項目

形式

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\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>

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

jrunscript test.js arg1 arg2 arg3

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

関連項目

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