عرض مصدر Ruby/Regexp/match

<noinclude>{{DISPLAYTITLE: التابع <code>match‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Regexp]]
يُعيد التابع <code>match</code> كائنًا من النوع <code>MatchData</code> يصف المطابقة، أو يعيد <code>nil</code> إذا لم يكن هناك تطابق. هذا يُكافئ استرداد قيمة المتغير الخاص <code>$~</code> بعد مطابقة عادية. في حال تمرير الوسيط الثاني،، فإنه يحدد الموضع في السلسلة النصية لبدء البحث.

في حال تمرير كتلة، قسيستدعي الكتلة باستخدام <code>[[Ruby/MatchData|MatchData]]</code> إذا نجحت المطابقة، هكذا يمكنك كتابة:

بدلًا من:

قيمة المعادة هي قيمة ناتجة عن تنفيذ الكتلة في هذه الحالة.
==البنية العامة==
<syntaxhighlight lang="ruby">match(str) → matchdata or nil
match(str,pos)→ matchdata or nil‎</syntaxhighlight>
==المعاملات==
===<code>str‎</code>===
سلسلة نصية.
===<code>pos‎</code>===

==القيمة المُعادة==

==أمثلة==
مثال على استخدام التابع <code>match‎</code>:
<syntaxhighlight lang="ruby">/(.)(.)(.)/.match("abc")[2]   #=> "b"
/(.)(.)/.match("abc", 1)[2]   #=> "c"‎</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Regexp/inspect|inspect]]</code>: يعيد  نسخة نصية منسقة من التعبير النمطي . قد يكون من المفاجئ أن تعلم أن <code>#inspect</code> ينتج في الواقع نسخة طبيعية من السلسلة النصية أكثر حتى من التابع <code>#to_s</code>.
* التابع <code>[[Ruby/Regexp/match-3F|match?‎]]</code>: يُعيد  القيمة <code>true</code> أو <code>false</code> بحسب ما إذا كان التعبير النمطي قد طوبِق أم لا دون تحديث المتغير $~ والمتغيرات الأخرى ذات الصلة. في حال إعطاء الوسيط الثاني، فإنّه يحدد الموضع في السلسلة النصية لبدء البحث.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-i-match قسم  التابع match‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]