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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>offset‎</code> الخاص بالصنف <code>MatchData</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>MatchData.offset‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby MatchData]]
 
[[تصنيف: Ruby MatchData]]
يعيد التابع <code>offset</code> مصفوفة ثنائية تحتوي موضعي (offsets) البداية والنهاية للمطابقة رقم <code>n</code>. الوسيط <code>n</code> يمكن أن يكون سلسلة نصية أو رمزًا للإشارة إلى مطابقة (capture) معينة.
+
يعيد التابع <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> مصفوفة ثنائية تحتوي موضعي (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/post_match|post_match]]</code>: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية.
+
*التابع <code>[[Ruby/MatchData/post match|post_match]]</code>: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية.
 
 
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/MatchData.html#method-i-offset قسم التابع offset‎ في الصنف MatchData‎ في توثيق روبي الرسمي.]
+
*[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) الحالية من السلسلة النصية الأصلية.

مصادر