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