التابع MatchData.begin‎ في روبي

يعيد التابع 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 من مصفوفة التطابق في السلسلة النصية.

مصادر

• قسم التابع begin‎ في الصنف MatchData‎ في توثيق روبي الرسمي.