التابع named_captures‎ الخاص بالصنف Regexp في روبي

يُعيد التابع named_captures قاموسًا (hash) يحتوي معلومات حول الالتقاطات المسماة (named captures) لتتعبير النمطي الذي استُدعي معه. مفاتيح (keys) القاموس هي أسماء الالتقاطات المعينة. أما قيم القاموس فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة.

إذا لم يكن هناك أي التقاطات مسماة، فسيعاد قاموس فارغ.

البنية العامة

named_captures  → hash‎

أمثلة

مثال على استخدام التابع named_captures‎:

/(?<foo>.)(?<bar>.)/.named_captures
#=> {"foo"=>[1], "bar"=>[2]}
/(?<foo>.)(?<foo>.)/.named_captures
#=> {"foo"=>[1, 2]}‎

انظر أيضا

• التابع match?‎: يُعيد القيمة true أو false بحسب ما إذا كان التعبير النمطي قد طوبِق أم لا دون تحديث المتغير $~ والمتغيرات الأخرى ذات الصلة. في حال إعطاء الوسيط الثاني، فإنّه يحدد الموضع في السلسلة النصية لبدء البحث.
• التابع names: يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) على هبئة مصفوفة من سلاسل نصية.

مصادر

• قسم التابع named_captures‎ في الصنف Regexp‎ في توثيق روبي الرسمي.