الفرق بين المراجعتين ل"Ruby/MatchData/begin"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>begin‎</code> الخاص بالصنف <code>MatchData</code> في روبي}}</noinclude> تصنيف: Ruby تصن...')
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby MatchData]]
 
[[تصنيف: Ruby MatchData]]
يعيد التابع <code>begin</code> موضع (offset) بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية. n يمكن أن يكون سلسلة نصية أو رمز للإشارة إلى جزء مُطابق معيّن.
+
يعيد التابع <code>begin</code> موضع (offset) بداية العنصر رقم <code>n</code> من مصفوفة التطابق في السلسلة النصية. <code>n</code> يمكن أن يكون سلسلة نصية أو رمزًا للإشارة إلى جزء مُطابق (capture) معيّن.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">begin(n)→ integer‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">begin(n)→ integer‎</syntaxhighlight>
سطر 9: سطر 9:
 
===<code>n‎</code>===
 
===<code>n‎</code>===
  
 
+
يحدد رقم عنصر من مصفوفة التطابق في السلسلة النصية.
 
==القيمة المُعادة==
 
==القيمة المُعادة==
 +
يعيد التابع <code>begin</code> موضع بداية العنصر رقم <code>n</code> من مصفوفة التطابق في السلسلة النصية.
  
 
==أمثلة==
 
==أمثلة==
سطر 21: سطر 22:
 
p m.begin(:bar)  #=> 2‎</syntaxhighlight>
 
p m.begin(:bar)  #=> 2‎</syntaxhighlight>
 
==انظر أيضا==
 
==انظر أيضا==
* التابع <code>[[Ruby/MatchData/5B-5D|[]]]</code>: تتصرف <code>MatchData</code> كمصفوفة، ويمكن الدخول إليهت باستخدام تقنيات فهرسة المصفوفات العادية.  التعبير <code>mtch[0]</code> مكافئ للمتغير الخاص <code>$&</code>، لذلك فهو يعيد كامل السلسلة النصية المُطابقة.  فيما تعيد التعابير <code>mtch[1]</code> و <code>mtch[2]</code> وهلم جرا، القيم المؤشرة (backdferences) المتطابقة (أجزاء النمط الموجودة بين قاسين).
+
* التابع <code>[[Ruby/MatchData/captures|captures]]</code>: يعيد مصفوفة الأجزاء المُطابقة (array of captures).
* التابع <code>[[Ruby/MatchData/captures|captures]]</code>: يعيد ظظظ مصفوفة الأجزاء المُطابقة (array of captures)؛ يكافئ <code>mtch.to_a[1..-1]</code>.
 
  
 
==مصادر==
 
==مصادر==
 
*[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-begin قسم  التابع begin‎ في الصنف MatchData‎ في توثيق روبي الرسمي.]
 
*[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-begin قسم  التابع begin‎ في الصنف MatchData‎ في توثيق روبي الرسمي.]

مراجعة 22:49، 24 أكتوبر 2018

يعيد التابع begin موضع (offset) بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية. n يمكن أن يكون سلسلة نصية أو رمزًا للإشارة إلى جزء مُطابق (capture) معيّن.

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

begin(n) integer

المعاملات

n‎

يحدد رقم عنصر من مصفوفة التطابق في السلسلة النصية.

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

يعيد التابع begin موضع بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية.

أمثلة

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

m = /(.)(.)(\d+)(\d)/.match("THX1138.")
m.begin(0)       #=> 1
m.begin(2)       #=> 2
m = /(?<foo>.)(.)(?<bar>.)/.match("hoge")
p m.begin(:foo)  #=> 0
p m.begin(:bar)  #=> 2‎

انظر أيضا

  • التابع captures: يعيد مصفوفة الأجزاء المُطابقة (array of captures).

مصادر