.\" Copyright (c) 2006, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JRUNSCRIPT" "1" "2021" "JDK 17" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
jrunscript \- اجرای یک شل اسکریپت‌نویسی خط فرمانی با پشتیبانی از حالت‌های تعاملی و دسته‌ای
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]نکته:\f[R]
.PP
این ابزار \f[B]آزمایشی\f[R] است و پشتیبانی نمی‌شود.
.PP
\f[CB]jrunscript\f[R] [\f[I]options\f[R]] [\f[I]arguments\f[R]]
.TP
.B \f[I]options\f[R]
این بخش بیانگر گزینه‌های خط فرمان \f[CB]jrunscript\f[R] است که می‌توانند استفاده شوند.
بخش \f[B]گزینه‌های دستور jrunscript\f[R] را ببینید.
.RS
.RE
.TP
.B \f[I]arguments\f[R]
آرگومان‌ها، در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور قرار می‌گیرند.
بخش \f[B]آرگومان‌ها\f[R] را ببینید.
.RS
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[CB]jrunscript\f[R] یک شل اسکریپت‌نویسی خط فرمانیِ مستقل از زبان است.
دستور \f[CB]jrunscript\f[R] هم از حالت تعاملی (read\-eval\-print) و هم از حالت دسته‌ای (گزینهٔ \f[CB]\-f\f[R]) برای اجرای اسکریپت پشتیبانی می‌کند.
به‌طور پیش‌فرض، JavaScript زبان استفاده‌شده است، اما می‌توان از گزینهٔ \f[CB]\-l\f[R] برای مشخص کردن زبانی دیگر استفاده کرد.
دستور \f[CB]jrunscript\f[R] با استفاده از ارتباط میان جاوا و زبان اسکریپت‌نویسی، از سبک برنامه‌نویسی کاوشگرانه پشتیبانی می‌کند.
.PP
در صورت استفاده از JavaScript، دستور \f[CB]jrunscript\f[R] پیش از ارزیابی اسکریپت تعریف‌شده توسط کاربر، توابع و اشیاء توکار مشخصی را مقداردهی اولیه می‌کند که در مستندات مشخصات API برای توابع توکار JavaScript در \f[CB]jrunscript\f[R] شرح داده شده‌اند.
.SH "گزینه‌های دستور JRUNSCRIPT (OPTIONS FOR THE JRUNSCRIPT COMMAND)"
.TP
.B \f[CB]\-cp\f[R] \f[I]path\f[R] یا \f[CB]\-classpath\f[R] \f[I]path\f[R]
محل قرارگیری فایل‌های کلاسی که اسکریپت برای دسترسی به آن‌ها نیاز دارد را مشخص می‌کند.
.RS
.RE
.TP
.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
یک ویژگی سیستمی جاوا را تنظیم می‌کند.
.RS
.RE
.TP
.B \f[CB]\-J\f[R]\f[I]flag\f[R]
پرچم \f[I]flag\f[R] را مستقیماً به ماشین مجازی جاوا که دستور \f[CB]jrunscript\f[R] در آن اجرا می‌شود ارسال می‌کند.
.RS
.RE
.TP
.B \f[CB]\-l\f[R] \f[I]language\f[R]
از زبان اسکریپت‌نویسی تعیین‌شده استفاده می‌کند.
به‌طور پیش‌فرض، از JavaScript استفاده می‌شود.
برای استفاده از سایر زبان‌های اسکریپت‌نویسی، باید فایل JAR مربوط به موتور اسکریپت را با گزینهٔ \f[CB]\-cp\f[R] یا \f[CB]\-classpath\f[R] مشخص کنید.
.RS
.RE
.TP
.B \f[CB]\-e\f[R] \f[I]script\f[R]
اسکریپت تعیین‌شده را ارزیابی و اجرا می‌کند.
از این گزینه می‌توان برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند استفاده کرد.
.RS
.RE
.TP
.B \f[CB]\-encoding\f[R] \f[I]encoding\f[R]
کدگذاری نویسه‌ها را که برای خواندن فایل‌های اسکریپت استفاده می‌شود مشخص می‌کند.
.RS
.RE
.TP
.B \f[CB]\-f\f[R] \f[I]script\-file\f[R]
فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).
.RS
.RE
.TP
.B \f[CB]\-f\ \-\f[R]
برای خواندن و ارزیابی اسکریپت از ورودی استاندارد، وارد حالت تعاملی می‌شود.
.RS
.RE
.TP
.B \f[CB]\-help\f[R] یا \f[CB]\-?\f[R]
پیام راهنما را نمایش می‌دهد و خارج می‌شود.
.RS
.RE
.TP
.B \f[CB]\-q\f[R]
فهرستی از تمام موتورهای اسکریپت موجود را نمایش می‌دهد و خارج می‌شود.
.RS
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.PP
اگر آرگومان‌هایی وجود داشته باشند و از هیچ‌یک از گزینه‌های \f[CB]\-e\f[R] یا \f[CB]\-f\f[R] استفاده نشده باشد، اولین آرگومان همان فایل اسکریپت خواهد بود و باقی آرگومان‌ها، در صورت وجود، به عنوان آرگومان‌های اسکریپت ارسال می‌شوند.
اگر از آرگومان‌ها به همراه گزینهٔ \f[CB]\-e\f[R] یا \f[CB]\-f\f[R] استفاده شود، تمام آرگومان‌ها به عنوان آرگومان‌های اسکریپت ارسال می‌گردند.
اگر آرگومان‌ها و گزینه‌های \f[CB]\-e\f[R] و \f[CB]\-f\f[R] ارائه نشوند، حالت تعاملی استفاده می‌شود.
.SH "مثال اجرای اسکریپت‌های درون‌خطی (EXAMPLE OF EXECUTING INLINE SCRIPTS)"
.RS
.PP
\f[CB]jrunscript\ \-e\ "print(\[aq]hello\ world\[aq])"\f[R]
.RE
.RS
.PP
\f[CB]jrunscript\ \-e\ "cat(\[aq]http://www.example.com\[aq])"\f[R]
.RE
.SH "مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (EXAMPLE OF USING SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE)"
.RS
.PP
\f[CB]jrunscript\ \-l\ js\ \-f\ test.js\f[R]
.RE
.SH "مثال حالت تعاملی (EXAMPLE OF INTERACTIVE MODE)"
.IP
.nf
\f[CB]
jrunscript
js>\ print(\[aq]Hello\ World\\n\[aq]);
Hello\ World
js>\ 34\ +\ 55
89.0
js>\ t\ =\ new\ java.lang.Thread(function()\ {\ print(\[aq]Hello\ World\\n\[aq]);\ })
Thread[Thread\-0,5,main]
js>\ t.start()
js>\ Hello\ World

js>
\f[R]
.fi
.SH "اجرای فایل اسکریپت با آرگومان‌های اسکریپت (RUN SCRIPT FILE WITH SCRIPT ARGUMENTS)"
.PP
در این مثال، فایل \f[CB]test.js\f[R] فایل اسکریپت است.
آرگومان‌های \f[CB]arg1\f[R]، \f[CB]arg2\f[R] و \f[CB]arg3\f[R] به اسکریپت ارسال می‌شوند.
اسکریپت می‌تواند با استفاده از آرایهٔ arguments به این آرگومان‌ها دسترسی پیدا کند.
.RS
.PP
\f[CB]jrunscript\ test.js\ arg1\ arg2\ arg3\f[R]
.RE