الفرق بين المراجعتين لصفحة: «Ruby/MatchData/offset»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>offset | <noinclude>{{DISPLAYTITLE: التابع <code>MatchData.offset</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby MatchData]] | [[تصنيف: Ruby MatchData]] | ||
يعيد التابع <code>offset</code> مصفوفة | يعيد التابع <code>offset</code> مصفوفة بعنصرين تحوي موضعي (مقدار إزاحة [offsets]) البداية والنهاية للمطابقة <code>n</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">offset(n)→ array</syntaxhighlight> | <syntaxhighlight lang="ruby">offset(n)→ array</syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
===<code>n</code>=== | ===<code>n</code>=== | ||
رقم المطابقة. المعامل <code>n</code> يمكن أن يكون سلسلةً نصيةً أو رمزًا للإشارة إلى مطابقة (capture) معينة. | |||
رقم المطابقة. | ==القيمة المعادة== | ||
==القيمة | تعاد مصفوفة بعنصرين تحوي موضعي (offsets) البداية والنهاية للمطابقة ذات الرقم <code>n</code>. | ||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>offset</code>: | مثال على استخدام التابع <code>offset</code>:<syntaxhighlight lang="ruby">m = /(.)(.)(\d+)(\d)/.match("THX1138.") | ||
<syntaxhighlight lang="ruby">m = /(.)(.)(\d+)(\d)/.match("THX1138.") | |||
m.offset(0) #=> [1, 7] | m.offset(0) #=> [1, 7] | ||
m.offset(4) #=> [6, 7] | m.offset(4) #=> [6, 7] | ||
| سطر 22: | سطر 19: | ||
p m.offset(:bar) #=> [2, 3]</syntaxhighlight> | p m.offset(:bar) #=> [2, 3]</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/MatchData/names|names]]</code>: يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) كمصفوفة من سلاسل نصية. | *التابع <code>[[Ruby/MatchData/names|names]]</code>: يعيد قائمة بأسماء الأجزاء المُلتقطة (captures) كمصفوفة من سلاسل نصية. | ||
* التابع <code>[[Ruby/MatchData/ | *التابع <code>[[Ruby/MatchData/post match|post_match]]</code>: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-offset قسم | *[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-offset قسم التابع offset في الصنف MatchData في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 11:15، 17 نوفمبر 2018
يعيد التابع 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) الحالية من السلسلة النصية الأصلية.