الصنف 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

يستخدم الفهارس المُمرَّرة إليه للوصول إلى قيم العناصر المُتطابقة ثم يعيدها.

مصادر