عرض مصدر Ruby/Kernel/exec

<noinclude>{{DISPLAYTITLE: التابع <code>exec‎</code> الخاص بالصنف <code>Kernel</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Kernel]]
يستبدل التابع <code>exec</code> العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى والذي يمكن أن يأخذ أحد الأشكال التالية:
{| class="wikitable"
!الأمر
!الوصف
|-
|<code>exec(commandline)‎</code>
|أحد أوامر سطر الأوامر (command line) والذي يُمرّر إلى الصدفة (shell) القياسية.
|-
|<code>exec(cmdname, arg1, ...)</code> ‎
|اسم أمر (command name) ووسيط واحد أو أكثر (بدون صدفة).
|-
|<code>exec([cmdname, argv0], arg1, ...)‎</code>
|اسم أمر وكائن <code>argv</code>، مع إمكانية إضافة وسائط أخرى (بدون صدفة shell).
|}في الشكل الأول، تؤخذ السلسلة النصية باعتبارها أمرًا يراد تنفيذه في سطر أوامر، ثم تعمل الصدفة على بتبسيطه (expansion) قبل أن يتم تنفيذه.
__TOC__
الصدفة القياسية تعني دائمًا <code>"/bin/sh"</code> على الأنظمة المشابهة بيونكس، مثل <code>ENV["RUBYSHELL"]‎</code> (أو <code>ENV["COMSPEC"]‎</code> على منصات Windows NT)، وما شابه.

في حال استعملت السلسلة النصية من الشكل الأول (أي الشكل <code>exec("command")</code>‎)، فستتبع هذه القواعد البسيطة:
*ليس هنالك محارف خاصة (meta characters)، و
*لا كلمات مخصصة للصدفة أو مدمجة (built-in) فيها، و
*تستدعي روبي الأمر مباشرة دون صدفة.
يمكنك فرض استدعاء الصدفة بإضافة <code>؛</code> إلى السلسلة النصية (لأن <code>؛</code> محرف خاص).

انتبه إلى أنَّ هذا السلوك يمكن ملاحظته في كون مُعرِّف العملية (pid) الذي تم الحصول عليه (من طرف <code>spawn()‎</code> و <code>[[Ruby/IO/pid|IO.pid]]</code> بالنسبة للتابع <code>[[Ruby/IO/popen|IO.popen]]</code>) هو معرف العملية للأمر المستدعى، وليس للصدفة.

في الشكل الثاني ‎(<code>exec("command1", "arg1",...)</code>) ‎، يتم اعتبار الوسيط الأول كاسم للأمر، أما البقية فتُمرّر كوسائط للأمر دون أن تبسُطها الصدفة.

الشكل الثالث ‎(<code>exec(["command", "argv0"],"arg1", ...)</code>)‎ يُبدأ بمصفوفة ثنائية في بداية الأمر، عنصرها الأول هو الأمر الذي سيتم تنفيذه، أما الثاني فيُستخدم كقيمة للوسيط <code>argv[0]‎</code>، والذي قد يظهر في قوائم العملية (process listings).
==البنية العامة==
<syntaxhighlight lang="ruby">exec([env,] command... [,options])‎</syntaxhighlight>من أجل تنفيذ الأمر <code>command</code>، ستُستخدم إحدى استدعاءات النظام <code>exec(2)‎</code>، لذلك فإنّ الأمر الجاري قد يرث بعض خصائص بيئة البرنامج الأصلي (بما في ذلك واصفات الملفات [file descriptors] المفتوحة).

يمكن تعديل هذا السلوك عبر الوسيطين <code>env</code> و <code>options</code>. انظر التابع <code>[[Ruby/Kernel/spawn|spawn]]</code> لمزيد من التفاصيل.

في حال فشل تنفيذ الأمر (عادةً الخطأ <code>Errno::ENOENT</code> عند عدم التمكن من العثور على الأمر) يتم إطلاق الاستثناء <code>[[Ruby/SystemCallError|SystemCallError]]</code>.

يعدّل التابع <code>exec</code> خصائص العملية وفقًا لقيمة الوسيط <code>options</code> قبل استدعاء النظام <code>exec(2)‎</code>. راجع صفحة التابع <code>[[Ruby/Kernel/spawn|spawn]]</code> لمزيد من التفاصيل حول الوسيط <code>options</code> المعطى.

قد يُحتفَظ بالخصائص المعدلة عند فشل استدعاء النظام <code>exec(2)‎</code>. على سبيل المثال، حدود الموارد الثابتة (hard resource limits) غير قابلة للاستعادة. إذا لم يناسبك هذا، فضع في بالك إنشاء عملية فرعية (child process) باستخدام <code>[[Ruby/Kernel/spawn|spawn]]</code> أو <code>[[Ruby/Kernel/system|system]]</code>.
==المعاملات==
===<code>env‎</code>===
يُستخدم هذا الوسيط لتعديل سلوك التابع <code>exec</code>.
===<code>command...‎</code>===
الأمر الخارجي المراد تنفيذه.
===<code>options‎</code>===
يُستخدم هذا الوسيط لتعديل سلوك التابع <code>exec</code>.
==أمثلة==
مثال على استخدام التابع <code>exec‎</code>:<syntaxhighlight lang="ruby">exec "echo *"       # echoes list of files in current directory
# never get here
exec "echo", "*"    # echoes an asterisk
# never get here</syntaxhighlight>
==انظر أيضا==
*التابع <code>[[Ruby/Kernel/eval|eval]]</code>: يقيم (Evaluates) التابع تعبيرات روبي الموجودة في سلاسل نصية.
*التابع <code>[[Ruby/Kernel/spawn|spawn]]</code>: يعيد التابع أمرًا محددا ويعيد معرّفه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-exec قسم التابع exec‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]