الفرق بين المراجعتين ل"Ruby/Regexp/named captures"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: التابع <code>named_captures | + | <noinclude>{{DISPLAYTITLE: التابع <code>Regexp.named_captures</code> في روبي}}</noinclude> |
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Regexp]] | [[تصنيف: Ruby Regexp]] | ||
− | يُعيد التابع <code>named_captures</code> | + | يُعيد التابع <code>named_captures</code> [[Ruby/Hash|جدول Hash]] يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النظامي الذي استُدعي معه. |
− | مفاتيح (keys) | + | مفاتيح (keys) [[Ruby/Hash|الجدول Hash]] هي أسماء الالتقاطات المعينة. أما قيم [[Ruby/Hash|الجدول Hash]] فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة. |
− | إذا لم يكن هناك أي التقاطات مسماة، فسيعاد | + | إذا لم يكن هناك أي التقاطات مسماة، فسيعاد [[Ruby/Hash|جدول Hash]] فارغ. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">named_captures → hash</syntaxhighlight> | <syntaxhighlight lang="ruby">named_captures → hash</syntaxhighlight> | ||
− | ==القيمة | + | ==القيمة المعادة== |
− | + | يعاد كائن من النوع <code>[[Ruby/Hash|Hash]]</code> يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النظامي المعطى. | |
==أمثلة== | ==أمثلة== | ||
سطر 21: | سطر 21: | ||
/(.)(.)/.named_captures | /(.)(.)/.named_captures | ||
#=> {}</syntaxhighlight> | #=> {}</syntaxhighlight> | ||
− | ==انظر | + | ==انظر أيضًا== |
− | *التابع <code>[[Ruby/Regexp/match-3F|match?]]</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 قسم | + | *[http://ruby-doc.org/core-2.5.1/Regexp.html#method-i-named_captures قسم التابع named_captures في الصنف 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) على هبئة مصفوفة من سلاسل نصية.