عرض مصدر Ruby/Regexp/named captures

<noinclude>{{DISPLAYTITLE: التابع <code>Regexp.named_captures‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Regexp]]
يُعيد التابع <code>named_captures</code> [[Ruby/Hash|جدول Hash]] يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي الذي استُدعي معه.

مفاتيح (keys) [[Ruby/Hash|الجدول Hash]] هي أسماء الالتقاطات المعينة. أما قيم [[Ruby/Hash|الجدول Hash]] فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة.

إذا لم يكن هناك أي التقاطات مسماة، فسيعاد [[Ruby/Hash|جدول Hash]] فارغ.
==البنية العامة==
<syntaxhighlight lang="ruby">named_captures  → hash‎</syntaxhighlight>
==القيمة المعادة==
يعاد كائن من النوع <code>[[Ruby/Hash|Hash]]</code> يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي المعطى.

==أمثلة==
مثال على استخدام التابع <code>named_captures‎</code>:<syntaxhighlight lang="ruby">/(?<foo>.)(?<bar>.)/.named_captures
#=> {"foo"=>[1], "bar"=>[2]}
/(?<foo>.)(?<foo>.)/.named_captures
#=> {"foo"=>[1, 2]}‎

/(.)(.)/.named_captures
#=> {}</syntaxhighlight>
==انظر أيضًا==
* التابع <code>[[Ruby/Regexp/match-3F|match?‎]]</code>: يتحقق ما إذا كان التعبير النمطي المعطى قد تطابق (matched) أم لا دون تحديث المتغير ‎<code>$~</code>‎ والمتغيرات الأخرى ذات الصلة.
*التابع <code>[[Ruby/Regexp/names|names]]</code>: يعيد  قائمة بأسماء الأجزاء المُلتقطة (captures) على هبئة مصفوفة من سلاسل نصية.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-i-named_captures قسم التابع named_captures‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]