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');
    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 を参照してください。