التابع exec الخاص بالصنف Kernel في روبي
يستبدل التابع exec العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى والذي يمكن أن يأخذ أحد الأشكال التالية:
| الأمر | الوصف |
|---|---|
exec(commandline)
|
أحد أوامر سطر الأوامر (command line) والذي يُمرّر إلى الصدفة (shell) القياسية. |
exec(cmdname, arg1, ...)
|
اسم أمر (command name) ووسيط واحد أو أكثر (بدون صدفة). |
exec([cmdname, argv0], arg1, ...)
|
اسم أمر وكائن argv، مع إمكانية إضافة وسائط أخرى (بدون صدفة shell).
|
في الشكل الأول، تؤخذ السلسلة النصية باعتبارها أمرًا يراد تنفيذه في سطر أوامر، ثم تعمل الصدفة على بتبسيطه (expansion) قبل أن يتم تنفيذه.
الصدفة القياسية تعني دائمًا "/bin/sh" على الأنظمة المشابهة بيونكس، مثل ENV["RUBYSHELL"] (أو ENV["COMSPEC"] على منصات Windows NT)، وما شابه.
في حال استعملت السلسلة النصية من الشكل الأول (أي الشكل exec("command"))، فستتبع هذه القواعد البسيطة:
- ليس هنالك محارف خاصة (meta characters)، و
- لا كلمات مخصصة للصدفة أو مدمجة (built-in) فيها، و
- تستدعي روبي الأمر مباشرة دون صدفة.
يمكنك فرض استدعاء الصدفة بإضافة ؛ إلى السلسلة النصية (لأن ؛ محرف خاص).
انتبه إلى أنَّ هذا السلوك يمكن ملاحظته في كون مُعرِّف العملية (pid) الذي تم الحصول عليه (من طرف spawn() و IO.pid بالنسبة للتابع IO.popen) هو معرف العملية للأمر المستدعى، وليس للصدفة.
في الشكل الثاني (exec("command1", "arg1",...)) ، يتم اعتبار الوسيط الأول كاسم للأمر، أما البقية فتُمرّر كوسائط للأمر دون أن تبسُطها الصدفة.
الشكل الثالث (exec(["command", "argv0"],"arg1", ...)) يُبدأ بمصفوفة ثنائية في بداية الأمر، عنصرها الأول هو الأمر الذي سيتم تنفيذه، أما الثاني فيُستخدم كقيمة للوسيط argv[0]، والذي قد يظهر في قوائم العملية (process listings).
البنية العامة
exec([env,] command... [,options])
من أجل تنفيذ الأمر command، ستُستخدم إحدى استدعاءات النظام exec(2)، لذلك فإنّ الأمر الجاري قد يرث بعض خصائص بيئة البرنامج الأصلي (بما في ذلك واصفات الملفات [file descriptors] المفتوحة).
يمكن تعديل هذا السلوك عبر الوسيطين env و options. انظر التابع spawn لمزيد من التفاصيل.
في حال فشل تنفيذ الأمر (عادةً الخطأ Errno::ENOENT عند عدم التمكن من العثور على الأمر) يتم إطلاق الاستثناء SystemCallError.
يعدّل التابع exec خصائص العملية وفقًا لقيمة الوسيط options قبل استدعاء النظام exec(2). راجع صفحة التابع spawn لمزيد من التفاصيل حول الوسيط options المعطى.
قد يُحتفَظ بالخصائص المعدلة عند فشل استدعاء النظام exec(2). على سبيل المثال، حدود الموارد الثابتة (hard resource limits) غير قابلة للاستعادة. إذا لم يناسبك هذا، فضع في بالك إنشاء عملية فرعية (child process) باستخدام spawn أو system.
المعاملات
env
يُستخدم هذا الوسيط لتعديل سلوك التابع exec.
command...
الأمر الخارجي المراد تنفيذه.
options
يُستخدم هذا الوسيط لتعديل سلوك التابع exec.
أمثلة
مثال على استخدام التابع exec:
exec "echo *" # echoes list of files in current directory
# never get here
exec "echo", "*" # echoes an asterisk
# never get here
انظر أيضا
- التابع
eval: يقيم (Evaluates) التابع تعبيرات روبي الموجودة في سلاسل نصية. - التابع
spawn: يعيد التابع أمرًا محددا ويعيد معرّفه.