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

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

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

offset(n)→ array‎

المعاملات

n‎

رقم المطابقة. المعامل n يمكن أن يكون سلسلةً نصيةً أو رمزًا للإشارة إلى مطابقة (capture) معينة.

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

تعاد مصفوفة بعنصرين تحوي موضعي (offsets) البداية والنهاية للمطابقة ذات الرقم n.

أمثلة

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

m = /(.)(.)(\d+)(\d)/.match("THX1138.")
m.offset(0)      #=> [1, 7]
m.offset(4)      #=> [6, 7]
m = /(?<foo>.)(.)(?<bar>.)/.match("hoge")
p m.offset(:foo) #=> [0, 1]
p m.offset(:bar) #=> [2, 3]‎

انظر أيضا

• التابع names: يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) كمصفوفة من سلاسل نصية.
• التابع post_match: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية.

مصادر

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