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

<noinclude>{{DISPLAYTITLE: التابع <code>last_match‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Regexp]]
يُعيد التابع <code>last_match</code> في الشكل الأول (انظر فقرة البنية العامة) كائنَ <code>[[Ruby/MatchData|MatchData]]</code> الذي تم إنشاؤه من آخر تطابق (match) ناجح للنمط.  وهو مكافئ لقراءة المتغير العام ‎<code>$~‎</code> (راجع المتغيرات العامة المخصوصة في صفحة <code>[[Ruby/Regexp|Regexp]]</code> لمزيد من التفاصيل).

في الشكل الثاني، يعيد التابع <code>last_match</code> الحقل رقم <code>n</code> في الكائن <code>[[Ruby/MatchData|MatchData]]</code>. يمكن أن يكون <code>n</code> عبارة عن سلسلة نصية أو رمزًا للإشارة إلى الالتقاط المسمى (named capture).

لاحظ أن <code>[[Ruby/Regexp/last_match|last_match]]</code> هو متغير محلي في مدى (scope) التابع أو المهمة الفرعية (thread) للتابع الذي أنجز النمط.
==البنية العامة==
<syntaxhighlight lang="ruby">last_match  → matchdata
last_match(n)  → str‎</syntaxhighlight>
==المعاملات==
===<code>n‎</code>===
سلسلة نصية أو رمز.

==القيمة المُعادة==
يُعيد التابع <code>last_match</code> في الشكل الأول كائنَ <code>[[Ruby/MatchData|MatchData]]</code> الذي تم إنشاؤه من آخر تطابق (match) ناجح للنمط. وفي الشكل الثاني، يعيد الحقل رقم <code>n</code> في الكائن <code>[[Ruby/MatchData|MatchData]]</code>.

==أمثلة==
مثال على استخدام التابع <code>last_match‎</code>:
<syntaxhighlight lang="ruby">/c(.)t/ =~ 'cat'        #=> 0
Regexp.last_match       #=> #<MatchData "cat" 1:"a">
Regexp.last_match(0)    #=> "cat"
Regexp.last_match(1)    #=> "a"
Regexp.last_match(2)    #=> nil
/(?<lhs>\w+)\s*=\s*(?<rhs>\w+)/ =~ "var = val"
Regexp.last_match       #=> #<MatchData "var = val" lhs:"var" rhs:"val">
Regexp.last_match(:lhs) #=> "var"
Regexp.last_match(:rhs) #=> "val"‎</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Regexp/match|match]]</code>: يتحقق مما إذا كان التعبير النمطي مُطابقا أم لا.

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