نام (NAME)

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

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

jrunscript [options] [arguments]

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

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

-classpath path: مشخص می‌کند که فایل‌های کلاس مورد نیاز اسکریپت در کجا قرار دارند.
-cp path: همانند -classpath path است.
-Dname=value: یک ویژگی سیستمی جاوا را تنظیم می‌کند.
-Jflag: فلگ flag را مستقیماً به ماشین مجازی جاوا (JVM) که دستور jrunscript در آن در حال اجراست ارسال می‌کند.
-l language: از زبان اسکریپت‌نویسی مشخص‌شده استفاده می‌کند. به‌طور پیش‌فرض از جاوااسکریپت استفاده می‌شود. برای استفاده از زبان‌های اسکریپت‌نویسی دیگر، باید فایل JAR موتور اسکریپت مربوطه را با گزینه -cp یا -classpath مشخص کنید.
-e script: اسکریپت مشخص‌شده را ارزیابی و اجرا می‌کند. از این گزینه می‌توان برای اجرای اسکریپت‌های تک‌خطی که کاملاً در خط فرمان مشخص شده‌اند استفاده کرد.
-encoding encoding: کدگذاری نویسه‌ها را برای خواندن فایل‌های اسکریپت مشخص می‌کند.
-f script-file: فایل اسکریپت مشخص‌شده را اجرا می‌کند (حالت دسته‌ای).
-f -: یک اسکریپت را از ورودی استاندارد خوانده و اجرا می‌کند (حالت تعاملی).
-help: پیام راهنما را نمایش داده و خارج می‌شود.
-?: پیام راهنما را نمایش داده و خارج می‌شود.
-q: تمام موتورهای اسکریپت موجود را فهرست کرده و خارج می‌شود.

آرگومان‌ها (ARGUMENTS)

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

مثال‌ها (EXAMPLES)

اجرای اسکریپت‌های درون‌خطی

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

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

استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت

jrunscript -l js -f test.js

حالت تعاملی

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>

اجرای فایل اسکریپت با آرگومان‌های اسکریپت

فایل test.js همان فایل اسکریپت است. آرگومان‌های arg1، arg2 و arg3 به اسکریپت ارسال می‌شوند. اسکریپت می‌تواند از طریق آرایه arguments به این آرگومان‌ها دسترسی پیدا کند.

jrunscript test.js arg1 arg2 arg3

همچنین ببینید (SEE ALSO)

اگر از جاوااسکریپت استفاده شود، دستور jrunscript پیش از ارزیابی اسکریپت تعریف‌شده توسط کاربر، توابع و اشیاء پیش‌ساخته معینی را مقداردهی اولیه می‌کند. این موارد پیش‌ساخته جاوااسکریپت در JsDoc-Toolkit در نشانی http://code.google.com/p/jsdoc-toolkit مستند شده‌اند.