التابع Regexp.named_captures
في روبي
يُعيد التابع named_captures
جدول Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي الذي استُدعي معه.
مفاتيح (keys) الجدول Hash هي أسماء الالتقاطات المعينة. أما قيم الجدول Hash فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة.
إذا لم يكن هناك أي التقاطات مسماة، فسيعاد جدول Hash فارغ.
البنية العامة
named_captures → hash
القيمة المعادة
يعاد كائن من النوع Hash
يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي المعطى.
أمثلة
مثال على استخدام التابع named_captures
:
/(?<foo>.)(?<bar>.)/.named_captures
#=> {"foo"=>[1], "bar"=>[2]}
/(?<foo>.)(?<foo>.)/.named_captures
#=> {"foo"=>[1, 2]}
/(.)(.)/.named_captures
#=> {}
انظر أيضًا
- التابع
match?
: يتحقق ما إذا كان التعبير النمطي المعطى قد تطابق (matched) أم لا دون تحديث المتغير $~
والمتغيرات الأخرى ذات الصلة. - التابع
names
: يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) على هبئة مصفوفة من سلاسل نصية.