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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

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

مفاتيح (keys) القاموس هي أسماء الالتقاطات المعينة. أما قيم القاموس فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة.

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

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

named_captures   hash

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

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

أمثلة

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

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

/(.)(.)/.named_captures
#=> {}

انظر أيضا

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

مصادر