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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>compile‎</code> الخاص بالصنف <code>InstructionSequence</code> في روبي}}</noinclude> تصنيف: Rub...'
 
ط مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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>.
يأخذ التابع <code>compile</code> اختياريا الوسائطً <code>file</code> و <code>[[Ruby/InstructionSequence/path|path]]</code> و <code>line</code> التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر <code>source</code>، والتي هي بيانات وصفية (metadata) تُربط بالكائن المُعاد <code>iseq</code>.
يتم استخدام الوسيط <code>options</code>، والذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو قاموسًا (<code>Hash</code>)، لتعديل السلوك الافتراضي لمصرّف روبيRuby [[Ruby/InstructionSequence|سلسلة التعليمات]] compiler compiler.
للحصول على مزيد من التفاصيل بخصوص خيارات التصريف المناسبة ، راجع الصفحة <code>[[Ruby/InstructionSequence/compile_option-3D|::compile_option=]]</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">compile(source[, file[, path[, line[, options]]]]) → iseq‎</syntaxhighlight>
<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>options</code>، والذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو جدول <code>[[Ruby/Hash|Hash]]</code>، لتعديل السلوك الافتراضي لمصرّف روبي.
 
لمزيد من التفاصيل بخصوص خيارات التصريف، راجع الصفحة <code>[[Ruby/InstructionSequence/compile_option-3D|=compile_option]]</code>.
==المعاملات==
==المعاملات==
===<code>source‎</code>===
===<code>source‎</code>===
سلسلة نصية.
===<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>[[Ruby/InstructionSequence|InstructionSequence]]</code>.


==أمثلة==
==أمثلة==
سطر 22: سطر 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>: يأخذ  وسيطًا <code>file</code> ، والذي هو سلسلة نصية (<code>[[Ruby/String|String]]</code>) تحتوي مسار ملف روبي المصدري، ثم يقرأ ويحلل (parses) ويُصرّف (compiles) الملف، ثم يعيد <code>iseq</code>، والذي هو كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code> يضم البيانات الوصفية (metadata ) للمصدر.
* التابع <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) الملف المعطى.

مصادر