الفرق بين المراجعتين ل"Ruby/Regexp/named captures"

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

المراجعة الحالية بتاريخ 05:49، 4 ديسمبر 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) على هبئة مصفوفة من سلاسل نصية.

مصادر