صفحة الصنف InstructionSequence في روبي

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

يمثل الصنف InstructionSequence تسلسلًا مصرّفًا (compiled sequence) للتعليمات الخاصة بالآلة الافتراضية (Virtual Machine) لروبي.

يمكّنك هذا الصنف من الحصول على مؤشر (handle) للتعليمات التي تشكل التابع أو الكتلة البرمجية، وتصريف (compile) سلاسل روبي النصية إلى تعليمات الآلة الافتراضية (VM)، وتفكيك التعليمات إلى سلاسل نصية لتسهيل فحصها.

هذا الصنف مفيد للغاية إن كنت ترغب في معرفة كيفية عمل آلة روبي الافتراضية، لكنه يتيح لك أيضًا التحكم في إعدادات مصرف روبي Ruby iseq compiler.

يمكنك العثور على مصدر إرشادات الآلة الافتراضية في الصفحة insns.defفي توثيق روبي.

من شبه المؤكد أن نتائج سلاسل التعليمات سوف تتغير مع تغير روبي، لذلك قد يكون ناتج الأمثلة في صفحات هذا التوثيق مختلفًا عما لديك.

توابع الصنف العامة (Public Class Methods)

التابع compile

يأخذ وسيطًا source ، ويُصرّفه (compiles) إلى كائن من النوع InstructionSequence.

التابع compile_file

يأخذ وسيطًا file ، ثم يقرؤه ويحلله (parses) ويُصرّفه (compiles)، ثم يعيد كائنا من النوع InstructionSequence

التابع compile_option

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

التابع compile_option=‎

يضبط القيم الافتراضية لتحسين أداء المصرف

التابع disasm

يعيد سلسلة نصية (String) تحتوي تعليمات قابلة للقراءة.

التابع disassemble

يعيد سلسلة نصية (String) تحتوي تعليمات قابلة للقراءة.

التابع load_from_binary

يُحمّل التابع load_from_binary سلسلة تعليمات من سلسلة نصية ثنائية (binary format String) مُنشأ بواسطة to_binary.

التابع load_from_binary_extra_data

يُحمّل البيانات الإضافية المُضمّنة في السلسلة النصية الثنائية المعطاة.

التابع new

يأخذ وسيطًا source ويُصرّفه إلى كائن من النوع InstructionSequence.

التابع of

يُعيد التابع of سلسلة التعليمات التي تحتوي كائن proc أو method المعطى.

توابع النسخ العامة (Public Instance Methods)

التابع absolute_path

يُعيد المسار المطلق

التابع base_label

يُعيد التسمية الأساسية (base label).

التابع disasm

يعيد سلسلة نصية (String) تحتوي تعليمات قابلة للقراءة.

التابع disassemble

يُعيد سلسلة نصية (String) تحتوي تعليمات قابلة للقراءة.

التابع each_child

يًكرّر (Iterate) الكتلة المعطاة على جميع سلاسل التعليمات المنحدرة مباشرة من سلسلة التعليمات التي استدعي معها.

التابع eval

يقيّم (Evaluates) سلسلة التعليمات ويُعيد النتيجة.

التابع first_lineno

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

التابع inspect

يعيد تمثيلًا نصيا قابلًا للقراءة سلسلة التعليمات

التابع label

يُعيد تسمية (label) لسلسلة التعليمات.

التابع path

يُعيد مسار سلسلة التعليمات.

التابع to_a

يُعيد مصفوفة(Array) تتألف من 14 عنصرًا يمثلون سلسلة التعليمات.

التابع to_binary

يُسلسل (serialize) سلسلة التعليمات

التابع trace_points

يُعيد نقاط التعقب (trace points) في سلسلة التعليمات.