التابع Regexp.named_captures‎ في روبي

من موسوعة حسوب
< Ruby‏ | Regexp
مراجعة 15:19، 3 ديسمبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.)
اذهب إلى التنقل اذهب إلى البحث

يُعيد التابع 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) على هبئة مصفوفة من سلاسل نصية.

مصادر