عرض مصدر Ruby/MatchData/index

<noinclude>{{DISPLAYTITLE: معامل الفهرسة <code>[]‎</code> الخاص بالصنف <code>MatchData</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Operator]]
[[تصنيف: Ruby MatchData]]
تتصرف الكائنات <code>[[Ruby/MatchData|MatchData]]</code> بشكل مشابه للمصفوفات، إذ يمكن الوصول إليها باستخدام تقنيات فهرسة المصفوفات العادية.  

التعبير <code>mtch[0]‎</code> مكافئ للمتغير الخاص ‎‎<code>$&‎</code>، لذلك فهو يعيد كامل السلسلة النصية المُطابقة بينما تعيد التعابير <code>mtch[1]‎</code> و <code>mtch[2]‎</code> ...إلخ. قيم العناصر المتطابقة سابقًا (تدعى "المراجع الخلفية" [backreferences]) من أجزاء النمط الموجودة بين قوسين.
==البنية العامة==
<syntaxhighlight lang="ruby">mtch[i]→ str or nil
mtch[start, length]→ array
mtch[range]  → array
mtch[name]→ str or nil‎</syntaxhighlight>
==القيمة المعادة==
يعيد التعبير <code>mtch[0]‎</code>  كامل السلسلة النصية المُطابقة بينما تعيد التعابير <code>mtch[1]‎</code> و <code>mtch[2]‎</code> ...إلخ. قيم العناصر المتطابقة سابقًا.
==أمثلة==
مثال على استخدام المعامل <code>[]‎</code>:<syntaxhighlight lang="ruby">m = /(.)(.)(\d+)(\d)/.match("THX1138.")
m          #=> #<MatchData "HX1138" 1:"H" 2:"X" 3:"113" 4:"8">
m[0]       #=> "HX1138"
m[1, 2]    #=> ["H", "X"]
m[1..3]    #=> ["H", "X", "113"]
m[-3, 2]   #=> ["X", "113"]
m = /(?<foo>a+)b/.match("ccaaab")
m          #=> #<MatchData "aaab" foo:"aaa">
m["foo"]   #=> "aaa"
m[:foo]    #=> "aaa"‎</syntaxhighlight>
==انظر أيضا==
*التابع <code>[[Ruby/MatchData/begin|begin]]</code>: يعيد موضع (offset) بداية العنصر رقم <code>n</code> من مصفوفة التطابق في السلسلة النصية.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-5B-5D <nowiki>قسم المعامل [‎] في الصنف MatchData‎ في توثيق روبي الرسمي.</nowiki>]