صفحة الصنف MatchData في روبي
MatchData هو نوع المتغير الخاص $~ ، كما أنه نوع الكائنات المُعادة من Regexp#match و Regexp.last_match. فهو يغلف ويستوعب جميع نتائج التطابق مع التعبير النمطي،
يمكن الدخول إلى النتائج من خلال المتغيرات الخاصة $& و $' و $ و $` و $1 و $2 وهكذا دواليك.
توابع الصنف العامة (Public Class Methods)
المعامل ==
معامل التساوي - يتطابق كائنان من النوع matchdata إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة.
التابع []
تتصرف MatchData كمصفوفة، ويمكن الدخول إليها باستخدام تقنيات فهرسة المصفوفات العادية.
التابع begin
يعيد موضع (offset) بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية.
التابع captures
يعيد مصفوفة الأجزاء المُطابقة (array of captures)؛
التابع end
يعيد موضع (offset) بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية.
التابع eql?
يتحقق من تساوي كائنين من النوع matchdata
التابع hash
يعيد التابع hash تكويد hash استنادًا إلى السلسلة النصية المستهدفة والتعبير النمطي (regexp) ومواضع المطابقة للكائن matchdata.
التابع inspect
يعيد نسخة قابلة للطباعة من mtch.
التابع length
يعيد عدد العناصر في مجموعة المطابقة.
التابع named_captures
يعيد قاموسًا (Hash) باستخدام الجزء المُطابق (capture) المعين.
التابع names
يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) كمصفوفة من سلاسل نصية.
التابع offset
يعيد مصفوفة ثنائية تحتوي موضعي (offsets) البداية والنهاية للمطابقة رقم n.
التابع post_match
يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية.
التابع pre_match
يعيد الجزء الذي يسبق المطابقة (match) الحالية من السلسلة النصية الأصلية.
التابع regexp
يعيد التعبير النمطي regexp.
التابع size
يعيد عدد العناصر في مصفوفة المطابقة.
التابع string
يعيد نسخة مُجمدة من السلسلة النصية التي تم تمريرها إلى match.
التابع to_a
يعيد مصفوفة المطابقات.
التابع to_s
يعيد كامل السلسلة النصية المُطابَقة.
التابع values_at
يستخدم الفهارس المعطاة index للدخول إلى القيم المُطابقة، ثم يعيد مجموعة من المطابقات المقابلة.