1 ." Copyright (c) 2006, 2011, Oracle and/or its affiliates. All rights reserved.

     1 '\" t

     2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     2 .\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.

     3 ."

     3 .\" Title: jrunscript

     4 ." This code is free software; you can redistribute it and/or modify it

     4 .\" Language: English

     5 ." under the terms of the GNU General Public License version 2 only, as

     5 .\" Date: 2013年11月21日

     6 ." published by the Free Software Foundation.

     6 .\" SectDesc: スクリプティング・ツール

     7 ."

     7 .\" Software: JDK 8

     8 ." This code is distributed in the hope that it will be useful, but WITHOUT

     8 .\" Arch: 汎用

     9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

     9 .\"

    10 ." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

    11 ." version 2 for more details (a copy is included in the LICENSE file that

    11 .\"

    12 ." accompanied this code).

    12 .\" This code is free software; you can redistribute it and/or modify it

    13 ."

    13 .\" under the terms of the GNU General Public License version 2 only, as

    14 ." You should have received a copy of the GNU General Public License version

    14 .\" published by the Free Software Foundation.

    15 ." 2 along with this work; if not, write to the Free Software Foundation,

    15 .\"

    16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    16 .\" This code is distributed in the hope that it will be useful, but WITHOUT

    17 ."

    17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License

    19 ." or visit www.oracle.com if you need additional information or have any

    19 .\" version 2 for more details (a copy is included in the LICENSE file that

    20 ." questions.

    20 .\" accompanied this code).

    21 ."

    21 .\"

    22 .TH jrunscript 1 "07 May 2011"

    22 .\" You should have received a copy of the GNU General Public License version

    23 

    23 .\" 2 along with this work; if not, write to the Free Software Foundation,

    24 .LP

    24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    25 .SH "名前"

    25 .\"

    26 jrunscript \- コマンド行スクリプトシェル

    26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    27 .LP

    27 .\" or visit www.oracle.com if you need additional information or have any

    28 .RS 3

    28 .\" questions.

    29 .TP 2

    29 .\"

    30 o

    30 .pl 99999

    31 形式 

    31 .TH "jrunscript" "1" "2013年11月21日" "JDK 8" "スクリプティング・ツール"

    32 .TP 2

    32 .\" -----------------------------------------------------------------

    33 o

    33 .\" * Define some portability stuff

    34 パラメータ 

    34 .\" -----------------------------------------------------------------

    35 .TP 2

    35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    36 o

    36 .\" http://bugs.debian.org/507673

    37 説明 

    37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

    38 .TP 2

    38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    39 o

    39 .ie \n(.g .ds Aq \(aq

    40 オプション 

    40 .el       .ds Aq '

    41 .TP 2

    41 .\" -----------------------------------------------------------------

    42 o

    42 .\" * set default formatting

    43 引数 

    43 .\" -----------------------------------------------------------------

    44 .TP 2

    44 .\" disable hyphenation

    45 o

    45 .nh

    46 例 

    46 .\" disable justification (adjust text to left margin only)

    47 .TP 2

    47 .ad l

    48 o

    48 .\" -----------------------------------------------------------------

    49 関連項目 

    49 .\" * MAIN CONTENT STARTS HERE *

    50 .RE

    50 .\" -----------------------------------------------------------------

    51 

    51 .SH "NAME"

    52 .LP

    52 jrunscript \- 対話型モードとバッチ・モードをサポートするコマンドライン・スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。

    53 .SH "形式"

    53 .SH "概要"

    54 .LP

    54 .sp

    55 .nf

    55 .if n \{\

    56 \f3

    56 .RS 4

    57 .fl

    57 .\}

    58 \fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]

    58 .nf

    59 .fl

    59 \fIjrunscript\fR [\fIoptions\fR] [\fIarguments\fR]

    60 .fi

    60 .fi

    61 

    61 .if n \{\

    62 .LP

    62 .RE

    63 .SH "パラメータ"

    63 .\}

    64 .LP

    64 .PP

    65 .RS 3

    65 \fIoptions\fR

    66 .TP 3

    66 .RS 4

    67 options 

    67 コマンドライン・オプション。オプションを参照してください。

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

    68 .RE

    69 .TP 3

    69 .PP

    70 arguments 

    70 \fIarguments\fR

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

    71 .RS 4

    72 .RE

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

    73 

    73 .RE

    74 .LP

    74 .SH "説明"

    75 .SH " 説明"

    75 .PP

    76 .LP

    76 \fIjrunscript\fRコマンドは、言語に依存しないコマンドライン・スクリプト・シェルです。\fIjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fI\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fI\-l\fRオプションを使用すれば他の言語も指定できます。\fIjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。

    77 .LP

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

    79 .LP

    80 .LP

    81 \f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。

    82 .LP

    84 .LP

    78 .PP

    85 .RS 3

    79 \-classpath \fIpath\fR

    86 .TP 3

    80 .RS 4

    87 \-classpath path 

    81 スクリプトがアクセスする必要のあるクラス・ファイルの場所を示します。

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

    82 .RE

    89 .TP 3

    83 .PP

    90 \-cp path 

    84 \-cp \fIpath\fR

    91 \-classpath \f2path\fP と同義です。 

    85 .RS 4

    92 .TP 3

    86 \fI\-classpath\fR

    93 \-Dname=value 

    87 \fIpath\fRと同じです。

    94 Java のシステムプロパティーを設定します。 

    88 .RE

    95 .TP 3

    89 .PP

    96 \-J<flag> 

    90 \-D\fIname\fR=\fIvalue\fR

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

    91 .RS 4

    98 .TP 3

    92 Javaのシステム・プロパティを設定します。

    99 \-l language 

    93 .RE

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

    94 .PP

   101 .TP 3

    95 \-J\fIflag\fR

   102 \-e script 

    96 .RS 4

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

    97 \fIflag\fRを、\fIjrunscript\fRコマンドが実行されているJava仮想マシンに直接渡します。

   104 .TP 3

    98 .RE

   105 \-encoding encoding 

    99 .PP

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

   100 \-I \fIlanguage\fR

   107 .TP 3

   101 .RS 4

   108 \-f script\-file 

   102 指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fI\-cp\fRまたは\fI\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。

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

   103 .RE

   110 .TP 3

   104 .PP

   111 \-f \- 

   105 \-e \fIscript\fR

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

   106 .RS 4

   113 .TP 3

   107 指定されたスクリプトを評価します。このオプションを使用すれば、コマンドラインにすべてが指定された1行スクリプトを実行できます。

   114 \-help\  

   108 .RE

   115 ヘルプメッセージを出力して終了します。 

   109 .PP

   116 .TP 3

   110 \-encoding \fIencoding\fR

   117 \-?\  

   111 .RS 4

   118 ヘルプメッセージを出力して終了します。 

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

   119 .TP 3

   113 .RE

   120 \-q\  

   114 .PP

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

   115 \-f \fIscript\-file\fR

   122 .RE

   116 .RS 4

   123 

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

   124 .LP

   118 .RE

   119 .PP

   120 \-f \-

   121 .RS 4

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

   123 .RE

   124 .PP

   125 \-help

   126 .RS 4

   127 ヘルプ・メッセージを表示して終了します。

   128 .RE

   129 .PP

   130 \-?

   131 .RS 4

   132 ヘルプ・メッセージを表示して終了します。

   133 .RE

   134 .PP

   135 \-q

   136 .RS 4

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

   138 .RE

   126 .LP

   140 .PP

   127 .LP

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

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

   129 .LP

   131 .LP

   143 .SS "インライン・スクリプトの実行"

   132 .SS 

   144 .sp

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

   145 .if n \{\

   134 .LP

   146 .RS 4

   135 .nf

   147 .\}

   136 \f3

   148 .nf

   137 .fl

   149 jrunscript \-e "print(\*(Aqhello world\*(Aq)"

   138 jrunscript \-e "print('hello world')"

   150 jrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)"

   139 .fl

   151 .fi

   140 jrunscript \-e "cat('http://java.sun.com')"

   152 .if n \{\

   141 .fl

   153 .RE

   142 \fP

   154 .\}

   143 .fi

   155 .SS "指定された言語の使用およびスクリプト・ファイルの評価"

   144 

   156 .sp

   145 .LP

   157 .if n \{\

   146 .SS 

   158 .RS 4

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

   159 .\}

   148 .LP

   160 .nf

   149 .nf

   161 jrunscript \-l js \-f test\&.js

   150 \f3

   162 .fi

   151 .fl

   163 .if n \{\

   152 jrunscript \-l js \-f test.js

   164 .RE

   153 .fl

   165 .\}

   154 \fP

   166 .SS "対話型モード"

   155 .fi

   167 .sp

   156 

   168 .if n \{\

   157 .LP

   169 .RS 4

   158 .SS 

   170 .\}

   159 対話型モード

   171 .nf

   160 .LP

   161 .nf

   162 \f3

   163 .fl

   165 .fl

   173 js> print(\*(AqHello World\en\*(Aq);

   166 js> print('Hello World\\n');

   167 .fl

   171 .fl

   176 89\&.0

   172 89.0

   177 js> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); })

   173 .fl

   174 js> t = new java.lang.Thread(function() { print('Hello World\\n'); })

   175 .fl

   177 .fl

   179 js> t\&.start()

   178 js> t.start()

   179 .fl

   181 .fl

   181  

   182 

   183 .fl

   185 .fl

   183 .fi

   186 \fP

   184 .if n \{\

   187 .fi

   185 .RE

   188 

   186 .\}

   189 .LP

   187 .SS "スクリプト引数を指定したスクリプト・ファイルの実行"

   190 .SS 

   188 .PP

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

   189 test\&.jsファイルはスクリプト・ファイルです。\fIarg1\fR、\fIarg2\fRおよび\fIarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。

   192 .LP

   190 .sp

   193 .nf

   191 .if n \{\

   194 \f3

   192 .RS 4

   195 .fl

   193 .\}

   196 jrunscript test.js arg1 arg2 arg3

   194 .nf

   197 .fl

   195 jrunscript test\&.js arg1 arg2 arg3

   198 \fP

   196 .fi

   199 .fi

   197 .if n \{\

   200 

   198 .RE

   201 .LP

   199 .\}

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

   204 .LP

   201 .PP

   205 .LP

   202 JavaScriptが使用される場合、ユーザー定義スクリプトを評価する前に、\fIjrunscript\fRコマンドはいくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScriptの組込みについては、http://code\&.google\&.com/p/jsdoc\-toolkit/にある

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

   203 JsDoc\-Toolkitを参照してください。

   207 .LP

   204 .br

   208  

   205 'pl 8.5i

   206 'bp