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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>begin‎</code> الخاص بالصنف <code>MatchData</code> في روبي}}</noinclude> تصنيف: Ruby تصن...')
 
ط
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>begin‎</code> الخاص بالصنف <code>MatchData</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>MatchData.begin‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby MatchData]]
 
[[تصنيف: Ruby MatchData]]
يعيد التابع <code>begin</code> موضع (offset) بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية. n يمكن أن يكون سلسلة نصية أو رمز للإشارة إلى جزء مُطابق معيّن.
+
يعيد التابع <code>begin</code> موضع (مقدار إزاحة [offset]) بداية العنصر <code>n</code> من مصفوفة التطابق في السلسلة النصية.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">begin(n)→ integer‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">begin(n)→ integer‎</syntaxhighlight>
سطر 9: سطر 9:
 
===<code>n‎</code>===
 
===<code>n‎</code>===
  
 
+
يحدد رقم عنصر من مصفوفة العناصر المتطابقة في السلسلة النصية. يمكن أن يكون سلسلةً نصيةً أو رمزًا للإشارة إلى جزء مُطابق (capture) معيّن.
==القيمة المُعادة==
+
==القيمة المعادة==
 +
يعيد التابع <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>.
+
* التابع <code>[[Ruby/MatchData/end|end]]</code>: يعيد موضع (offset) الحرف الذي يلي نهاية العنصر <code>n</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‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 09:15، 17 نوفمبر 2018

يعيد التابع begin موضع (مقدار إزاحة [offset]) بداية العنصر n من مصفوفة التطابق في السلسلة النصية.

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

begin(n) integer

المعاملات

n‎

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

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

يعيد التابع 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).
  • التابع end: يعيد موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية.

مصادر