.\" 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.19.2
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[R]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "JRUNSCRIPT" "1" "2023" "JDK 21" "دستورات JDK"
.hy
.SH "نام (NAME)"
.PP
jrunscript-openjdk21 \- شل خط فرمانی اسکریپت‌نویسی جاوا در OpenJDK 21
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]توجه:\f[R]
.PP
این ابزار \f[B]آزمایشی\f[R] بوده و پشتیبانی نمی‌شود.
.PP
\f[V]jrunscript\f[R] [\f[I]گزینه‌ها\f[R]] [\f[I]آرگومان‌ها\f[R]]
.TP
\f[I]گزینه‌ها\f[R]
نشان‌دهنده گزینه‌های خط فرمان قابل استفاده برای دستور \f[V]jrunscript\f[R] است.
بخش \f[B]گزینه‌ها (OPTIONS)\f[R] را ببینید.
.TP
\f[I]آرگومان‌ها\f[R]
آرگومان‌ها در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور قرار می‌گیرند.
بخش \f[B]آرگومان‌ها\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[V]jrunscript\f[R] یک شل خط فرمانی اسکریپت‌نویسی مستقل از زبان است.
دستور \f[V]jrunscript\f[R] از هر دو حالت تعاملی (read-eval-print) و حالت دسته‌ای (با گزینه \f[V]-f\f[R]) برای اجرای اسکریپت‌ها پشتیبانی می‌کند.
به‌طور پیش‌فرض از زبان جاوااسکریپت (JavaScript) استفاده می‌شود، اما با استفاده از گزینه \f[V]-l\f[R] می‌توان زبان دیگری را تعیین کرد.
دستور \f[V]jrunscript\f[R] با برقراری ارتباط میان جاوا و زبان اسکریپت‌نویسی، از سبک برنامه‌نویسی اکتشافی پشتیبانی می‌کند.
.PP
در صورت استفاده از جاوااسکریپت، دستور \f[V]jrunscript\f[R] پیش از ارزیابی اسکریپت کاربر، توابع و اشیاء درونی خاصی را مقداردهی اولیه می‌کند که در مشخصات API مربوط به توابع درونی جاوااسکریپت در \f[V]jrunscript\f[R] مستند شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[V]-cp\f[R] \f[I]path\f[R] یا \f[V]-classpath\f[R] \f[I]path\f[R]
محل قرارگیری فایل‌های کلاسی (class files) که اسکریپت برای دسترسی به آن‌ها نیاز دارد را مشخص می‌کند.
.TP
\f[V]-D\f[R]\f[I]name\f[R]\f[V]=\f[R]\f[I]value\f[R]
یک ویژگی سیستمی جاوا (Java system property) را مقداردهی می‌کند.
.TP
\f[V]-J\f[R]\f[I]flag\f[R]
فلگ \f[I]flag\f[R] را مستقیماً به ماشین مجازی جاوا (JVM) که دستور \f[V]jrunscript\f[R] روی آن در حال اجرا است ارسال می‌کند.
.TP
\f[V]-l\f[R] \f[I]language\f[R]
از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند.
به‌طور پیش‌فرض، جاوااسکریپت استفاده می‌شود.
برای استفاده از سایر زبان‌های اسکریپت‌نویسی، باید فایل JAR موتور اسکریپت‌نویسی مربوطه را با گزینه \f[V]-cp\f[R] یا \f[V]-classpath\f[R] مشخص کنید.
.TP
\f[V]-e\f[R] \f[I]script\f[R]
اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند.
از این گزینه می‌توان برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند استفاده کرد.
.TP
\f[V]-encoding\f[R] \f[I]encoding\f[R]
کدگذاری نویسه‌های مورداستفاده برای خواندن فایل‌های اسکریپت را مشخص می‌کند.
.TP
\f[V]-f\f[R] \f[I]script-file\f[R]
فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).
.TP
\f[V]-f -\f[R]
وارد حالت تعاملی می‌شود تا اسکریپت را از ورودی استاندارد بخواند و ارزیابی کند.
.TP
\f[V]-help\f[R] یا \f[V]-?\f[R]
پیام راهنما را نمایش داده و خارج می‌شود.
.TP
\f[V]-q\f[R]
فهرست تمام موتورهای اسکریپت‌نویسی موجود را نمایش داده و خارج می‌شود.
.SH "آرگومان‌ها (ARGUMENTS)"
.PP
اگر آرگومان‌هایی مشخص شوند و از هیچ‌یک از گزینه‌های \f[V]-e\f[R] یا \f[V]-f\f[R] استفاده نشده باشد، آرگومان اول فایل اسکریپت در نظر گرفته شده و سایر آرگومان‌ها (در صورت وجود) به عنوان آرگومان‌های اسکریپت ارسال می‌شوند.
اگر آرگومان‌ها همراه با گزینه \f[V]-e\f[R] یا \f[V]-f\f[R] استفاده شوند، تمامی آرگومان‌ها به عنوان آرگومان‌های اسکریپت ارسال خواهند شد.
اگر آرگومان‌ها و همچنین گزینه‌های \f[V]-e\f[R] و \f[V]-f\f[R] مشخص نشوند، از حالت تعاملی استفاده می‌شود.
.SH "مثال‌های اجرای اسکریپت‌های درون‌خطی (EXAMPLES)"
.RS
.PP
\f[V]jrunscript -e \[dq]print(\[aq]hello world\[aq])\[dq]\f[R]
.RE
.RS
.PP
\f[V]jrunscript -e \[dq]cat(\[aq]http://www.example.com\[aq])\[dq]\f[R]
.RE
.SH "مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت"
.RS
.PP
\f[V]jrunscript -l js -f test.js\f[R]
.RE
.SH "مثال حالت تعاملی"
.IP
.nf
\f[CB]
jrunscript
js> print(\[aq]Hello World\[rs]n\[aq]);
Hello World
js> 34 + 55
89.0
js> t = new java.lang.Thread(function() { print(\[aq]Hello World\[rs]n\[aq]); })
Thread[Thread-0,5,main]
js> t.start()
js> Hello World

js>
\f[R]
.fi
.SH "اجرای فایل اسکریپت با آرگومان‌های اسکریپت"
.PP
در این مثال، فایل \f[V]test.js\f[R] فایل اسکریپت است.
آرگومان‌های \f[V]arg1\f[R]، \f[V]arg2\f[R] و \f[V]arg3\f[R] به اسکریپت ارسال می‌شوند.
اسکریپت می‌تواند از طریق آرایه arguments به این آرگومان‌ها دسترسی پیدا کند.
.RS
.PP
\f[V]jrunscript test.js arg1 arg2 arg3\f[R]
.RE