التابع begin‎ الخاص بالصنف MatchData في روبي

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

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

begin(n)→ integer‎

أمثلة

مثال على استخدام التابع 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‎

انظر أيضا

• التابع []: تتصرف MatchData كمصفوفة، ويمكن الدخول إليهت باستخدام تقنيات فهرسة المصفوفات العادية. التعبير mtch[0] مكافئ للمتغير الخاص $&، لذلك فهو يعيد كامل السلسلة النصية المُطابقة. فيما تعيد التعابير mtch[1] و mtch[2] وهلم جرا، القيم المؤشرة (backdferences) المتطابقة (أجزاء النمط الموجودة بين قاسين).
• التابع captures: يعيد ظظظ مصفوفة الأجزاء المُطابقة (array of captures)؛ يكافئ mtch.to_a[1..-1].

مصادر

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