jrunscript(1)                   Scripting Tools                  jrunscript(1)



نام (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 در آن در حال اجراست ارسال می‌کند.

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

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

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

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

       -f -
              یک اسکریپت را از ورودی استاندارد خوانده و اجرا می‌کند (حالت
              تعاملی).

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

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

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

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

مثال‌ها (EXAMPLES)
   اجرای اسکریپت‌های درون‌خطی (EXECUTE INLINE SCRIPTS)
       jrunscript -e "print('hello world')"
       jrunscript -e "cat('http://www.example.com')"



   استفاده از زبان مشخص‌شده و ارزیابی فایل اسکریپت (USE SPECIFIED LANGUAGE AND
       EVALUATE THE SCRIPT FILE)
       jrunscript -l js -f test.js



   حالت تعاملی (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



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

JDK 8                          21 November 2013                  jrunscript(1)