JRUNSCRIPT(1)                    JDK Commands                    JRUNSCRIPT(1)

نام (NAME)
       jrunscript - اجرای یک شل اسکریپت‌نویسی خط فرمانی با پشتیبانی از حالت‌های
       تعاملی و دسته‌ای

خلاصه دستور (SYNOPSIS)
       نکته:

       این ابزار آزمایشی است و پشتیبانی نمی‌شود.

       jrunscript [options] [arguments]

       options
              این بخش بیانگر گزینه‌های خط فرمان jrunscript است که می‌توانند
              استفاده شوند.  بخش گزینه‌های دستور jrunscript را ببینید.

       arguments
              آرگومان‌ها، در صورت استفاده، بلافاصله پس از گزینه‌ها یا نام دستور
              قرار می‌گیرند.  بخش آرگومان‌ها را ببینید.

توضیحات (DESCRIPTION)
       دستور jrunscript یک شل اسکریپت‌نویسی خط فرمانیِ مستقل از زبان است.  دستور
       jrunscript هم از حالت تعاملی (read-eval-print) و هم از حالت دسته‌ای
       (گزینهٔ -f) برای اجرای اسکریپت پشتیبانی می‌کند.  به‌طور پیش‌فرض، JavaScript
       زبان استفاده‌شده است، اما می‌توان از گزینهٔ -l برای مشخص کردن زبانی دیگر
       استفاده کرد.  دستور jrunscript با استفاده از ارتباط میان جاوا و زبان
       اسکریپت‌نویسی، از سبک برنامه‌نویسی کاوشگرانه پشتیبانی می‌کند.

       در صورت استفاده از JavaScript، دستور jrunscript پیش از ارزیابی اسکریپت
       تعریف‌شده توسط کاربر، توابع و اشیاء توکار مشخصی را مقداردهی اولیه می‌کند
       که در مستندات مشخصات API برای توابع توکار JavaScript در jrunscript شرح
       داده شده‌اند.

گزینه‌های دستور JRUNSCRIPT (OPTIONS FOR THE JRUNSCRIPT COMMAND)
       -cp path یا -classpath path
              محل قرارگیری فایل‌های کلاسی که اسکریپت برای دسترسی به آن‌ها نیاز
              دارد را مشخص می‌کند.

       -Dname=value
              یک ویژگی سیستمی جاوا را تنظیم می‌کند.

       -Jflag پرچم flag را مستقیماً به ماشین مجازی جاوا که دستور jrunscript در
              آن اجرا می‌شود ارسال می‌کند.

       -l language
              از زبان اسکریپت‌نویسی تعیین‌شده استفاده می‌کند.  به‌طور پیش‌فرض، از
              JavaScript استفاده می‌شود.  برای استفاده از سایر زبان‌های
              اسکریپت‌نویسی، باید فایل JAR مربوط به موتور اسکریپت را با گزینهٔ
              -cp یا -classpath مشخص کنید.

       -e script
              اسکریپت تعیین‌شده را ارزیابی و اجرا می‌کند.  از این گزینه می‌توان
              برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند
              استفاده کرد.

       -encoding encoding
              کدگذاری نویسه‌ها را که برای خواندن فایل‌های اسکریپت استفاده می‌شود
              مشخص می‌کند.

       -f script-file
              فایل اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند (حالت دسته‌ای).

       -f -   برای خواندن و ارزیابی اسکریپت از ورودی استاندارد، وارد حالت
              تعاملی می‌شود.

       -help یا -?
              پیام راهنما را نمایش می‌دهد و خارج می‌شود.

       -q     فهرستی از تمام موتورهای اسکریپت موجود را نمایش می‌دهد و خارج
              می‌شود.

آرگومان‌ها (ARGUMENTS)
       اگر آرگومان‌هایی وجود داشته باشند و از هیچ‌یک از گزینه‌های -e یا -f
       استفاده نشده باشد، اولین آرگومان همان فایل اسکریپت خواهد بود و باقی
       آرگومان‌ها، در صورت وجود، به عنوان آرگومان‌های اسکریپت ارسال می‌شوند.  اگر
       از آرگومان‌ها به همراه گزینهٔ -e یا -f استفاده شود، تمام آرگومان‌ها به
       عنوان آرگومان‌های اسکریپت ارسال می‌گردند.  اگر آرگومان‌ها و گزینه‌های -e و
       -f ارائه نشوند، حالت تعاملی استفاده می‌شود.

مثال اجرای اسکریپت‌های درون‌خطی (EXAMPLE OF EXECUTING INLINE SCRIPTS)

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

              jrunscript -e "cat('http://www.example.com')"

مثال استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (EXAMPLE OF USING
       SPECIFIED LANGUAGE AND EVALUATE THE SCRIPT FILE)

              jrunscript -l js -f test.js

مثال حالت تعاملی (EXAMPLE OF INTERACTIVE MODE)

              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>


اجرای فایل اسکریپت با آرگومان‌های اسکریپت (RUN SCRIPT FILE WITH SCRIPT
       ARGUMENTS)
       در این مثال، فایل test.js فایل اسکریپت است.  آرگومان‌های arg1، arg2 و
       arg3 به اسکریپت ارسال می‌شوند.  اسکریپت می‌تواند با استفاده از آرایهٔ
       arguments به این آرگومان‌ها دسترسی پیدا کند.

              jrunscript test.js arg1 arg2 arg3

JDK 17                               2021                        JRUNSCRIPT(1)