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

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

يقرأ التابع compile_file ملف روبي المصدري ذا المسار المُمرَّر إليه ويحلله (parses) ويُصرّفه (compiles) ثم يعيد iseq، الذي هو الكائن InstructionSequence المصرَّف مع البيانات الوصفية (metadata) للمصدر.

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

compile_file(file[, options]) → iseq‎

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

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

المعاملات

`file‎`

سلسلة نصية تحدد موقع الملف المصدري.

`options‎`

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

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

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

أمثلة

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

# /tmp/hello.rb
puts "Hello, world!"
# elsewhere
RubyVM::InstructionSequence.compile_file("/tmp/hello.rb")
#=> <RubyVM::InstructionSequence:<main>@/tmp/hello.rb>‎

انظر أيضًا

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

مصادر

قسم التابع compile_file‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>compile_file‎</code> الخاص بالصنف <code>InstructionSequence</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>InstructionSequence.compile_file‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby InstructionSequence]]
-يأخذ التابع <code>compile_file</code> وسيطًا <code>file</code> (انظر فقرة البنية العامة)، والذي هو سلسلة نصية (<code>[[Ruby/String|String]]</code>) تحتوي مسار ملف روبي المصدري، ثم يقرأ ويحلل (parses) ويُصرّف (compiles) الملف، ثم يعيد <code>iseq</code>، والذي هو كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code> يضم البيانات الوصفية (metadata ) للمصدر.
+يقرأ التابع <code>compile_file</code> ملف روبي المصدري ذا المسار المُمرَّر إليه ويحلله (parses) ويُصرّفه (compiles) ثم يعيد <code>iseq</code>، الذي هو الكائن <code>[[Ruby/InstructionSequence|InstructionSequence]]</code> المصرَّف مع البيانات الوصفية (metadata) للمصدر.
+==البنية العامة==
-اختياريا يأخذ التابع <code>compile_file</code> الوسيط <code>options</code>، والذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو قاموسًا (<code>Hash</code>)، لتعديل السلوك الافتراضي للمصرف.
+<syntaxhighlight lang="ruby">compile_file(file[, options]) → iseq‎</syntaxhighlight>اختياريًّا، يأخذ التابع <code>compile_file</code> المعامل <code>options</code>، الذي يمكن أن تكون قيمته <code>true</code> أو <code>false</code> أو جدول <code>[[Ruby/Hash|Hash]]</code>، لتعديل السلوك الافتراضي للمصرِّف.
 لمزيد من التفاصيل بخصوص خيارات التصريف، راجع الصفحة <code>[[Ruby/InstructionSequence/compile_option-3D|compile_option=‎]]</code>.
-==البنية العامة==
-<syntaxhighlight lang="ruby">compile_file(file[, options]) → iseq‎</syntaxhighlight>
 ==المعاملات==
 ===<code>file‎</code>===
-اسم الملف
+سلسلة نصية تحدد موقع الملف المصدري.
 ===<code>options‎</code>===
-خيارات
+خيارات تتحكم بالمصرِّف.
-==القيمة المُعادة==
+==القيمة المعادة==
-يعيد كائنًا من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>
+يعاد كائنٌ من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
 ==أمثلة==
@@ سطر 26: / سطر 24: @@
 RubyVM::InstructionSequence.compile_file("/tmp/hello.rb")
 #=> <RubyVM::InstructionSequence:<main>@/tmp/hello.rb>‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/InstructionSequence/compile|compile]]</code>: يأخذ  وسيطًا <code>source</code> ، والذي هو سلسلة نصية (<code>[[Ruby/String|String]]</code>) تحتوي على أكواد برمجية لروبي ويُصرّفها (compiles) إلى كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
+* التابع <code>[[Ruby/InstructionSequence/compile|compile]]</code>: يصرِّف السلسلة النصية المُمرَّرة إليه والتي تحتوي على أكواد برمجية لروبي إلى كائن من النوع <code>[[Ruby/InstructionSequence|InstructionSequence]]</code>.
-* التابع <code>[[Ruby/InstructionSequence/compile_option|compile_option]]</code>: يعيد  قاموسا يحتوي الخيارات الافتراضية المستخدمة من المصرف.
+* التابع <code>[[Ruby/InstructionSequence/compile_option|compile_option]]</code>: يعيد كائنًا من النوع <code>[[Ruby/Hash|Hash]]</code> يحوي الخيارات الافتراضية المستخدمة من المصرف iseq لروبي.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/RubyVM/InstructionSequence.html#method-c-compile_file قسم  التابع compile_file‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/RubyVM/InstructionSequence.html#method-c-compile_file قسم التابع compile_file‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.]