الفرق بين المراجعتين لصفحة: «Ruby/InstructionSequence/compile»

من موسوعة حسوب
لا ملخص تعديل
ط مراجعة وتدقيق.
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>compile‎</code> الخاص بالصنف <code>InstructionSequence</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>InstructionSequence.compile‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby InstructionSequence]]
[[تصنيف: Ruby InstructionSequence]]
يأخذ التابع <code>compile</code> وسيطًا <code>source</code> (انظر فقرة البنية العامة)، والذي هو سلسلة نصية (<code>[[Ruby/String|String]]</code>) تحتوي على أكواد برمجية لروبي، ويُصرّفها (compiles) إلى كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
يصرِّف التابع <code>compile</code> السلسلة النصية المُمرَّرة إليه والتي تحتوي على أكواد برمجية لروبي إلى كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">compile(source[, file[, path[, line[, options]]]]) → iseq‎</syntaxhighlight>يأخذ التابع <code>compile</code> اختياريًّا المعاملات <code>file</code> و <code>path</code> و <code>line</code> التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر <code>source</code>؛ هذه المعاملات هي بيانات وصفية (metadata) تُربط بالكائن المُعاد.


يأخذ التابع <code>compile</code> اختياريا الوسائطً <code>file</code> و <code>path</code> و <code>line</code> التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر <code>source</code>، هذه الوسائط هي بيانات وصفية (metadata) تُربط بالكائن المُعاد.
يتم استخدام المعامل <code>options</code>، والذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو جدول <code>[[Ruby/Hash|Hash]]</code>، لتعديل السلوك الافتراضي لمصرّف روبي.
 
يتم استخدام الوسيط <code>options</code>، والذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو قاموسًا (<code>Hash</code>)، لتعديل السلوك الافتراضي لمصرّف روبي.


لمزيد من التفاصيل بخصوص خيارات التصريف، راجع الصفحة <code>[[Ruby/InstructionSequence/compile_option-3D|=compile_option]]</code>.
لمزيد من التفاصيل بخصوص خيارات التصريف، راجع الصفحة <code>[[Ruby/InstructionSequence/compile_option-3D|=compile_option]]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">compile(source[, file[, path[, line[, options]]]]) → iseq‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>source‎</code>===
===<code>source‎</code>===
سطر 17: سطر 15:


===<code>file‎</code>===
===<code>file‎</code>===
اسم المف
اسم الملف.


===<code>path‎</code>===
===<code>path‎</code>===
المسار
المسار المطلق.


===<code>line‎</code>===
===<code>line‎</code>===
رقم السطر
رقم السطر.


===<code>options‎</code>===
===<code>options‎</code>===
خيارات
خيارات تتحكم بالمصرِّف.


==القيمة المُعادة==
==القيمة المعادة==
يعيد التابع <code>compile</code> كائنا من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
يعاد كائنٌ من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.


==أمثلة==
==أمثلة==
سطر 35: سطر 33:
<syntaxhighlight lang="ruby">RubyVM::InstructionSequence.compile("a = 1 + 2")
<syntaxhighlight lang="ruby">RubyVM::InstructionSequence.compile("a = 1 + 2")
#=> <RubyVM::InstructionSequence:<compiled>@<compiled>>‎</syntaxhighlight>
#=> <RubyVM::InstructionSequence:<compiled>@<compiled>>‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/InstructionSequence/compile_file|compile_file]]</code>: يقرأ ويحلل (parses) ويُصرّف (compiles) الملف المعطى.
* التابع <code>[[Ruby/InstructionSequence/compile_file|compile_file]]</code>: يقرأ ويحلل (parses) ويُصرّف (compiles) الملف المعطى.


==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/RubyVM/InstructionSequence.html#method-c-compile قسم التابع compile‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/RubyVM/InstructionSequence.html#method-c-compile قسم التابع compile‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 06:30، 4 ديسمبر 2018

يصرِّف التابع compile السلسلة النصية المُمرَّرة إليه والتي تحتوي على أكواد برمجية لروبي إلى كائن من النوع InstructionSequence.

البنية العامة

compile(source[, file[, path[, line[, options]]]])  iseq

يأخذ التابع compile اختياريًّا المعاملات file و path و line التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر source؛ هذه المعاملات هي بيانات وصفية (metadata) تُربط بالكائن المُعاد.

يتم استخدام المعامل options، والذي يمكن أن تكون قيمته true أو false أو جدول Hash، لتعديل السلوك الافتراضي لمصرّف روبي.

لمزيد من التفاصيل بخصوص خيارات التصريف، راجع الصفحة =compile_option.

المعاملات

source‎

سلسلة نصية.

file‎

اسم الملف.

path‎

المسار المطلق.

line‎

رقم السطر.

options‎

خيارات تتحكم بالمصرِّف.

القيمة المعادة

يعاد كائنٌ من النوع InstructionSequence.

أمثلة

مثال على استخدام التابع compile‎:

RubyVM::InstructionSequence.compile("a = 1 + 2")
#=> <RubyVM::InstructionSequence:<compiled>@<compiled>>‎

انظر أيضًا

  • التابع compile_file: يقرأ ويحلل (parses) ويُصرّف (compiles) الملف المعطى.

مصادر