نام (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