الفرق بين المراجعتين ل"Ruby/Regexp/match-3F"

من موسوعة حسوب
< Ruby‏ | Regexp
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>match?‎‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude> تصنيف: Ruby تص...')
 
ط
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>match?‎‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>Regexp.match?‎‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Regexp]]
 
[[تصنيف: Ruby Regexp]]
يُعيد التابع <code>match?‎</code> القيمة <code>true</code> أو <code>false</code> بحسب ما إذا كان التعبير النمطي قد طوبِق أم لا دون تحديث المتغير $~ والمتغيرات الأخرى ذات الصلة. في حال إعطاء الوسيط الثاني، فإنّه يحدد الموضع في السلسلة النصية لبدء البحث.
+
يتحقق التابع <code>match?‎</code> ما إذا كان التعبير النمطي المعطى قد تطابق (matched) أم لا دون تحديث المتغير ‎<code>$~</code>‎ والمتغيرات الأخرى ذات الصلة.  
 +
 
 +
في حال إعطاء الوسيط الثاني، فسيحدد موضع بدء البحث والمطابقة في السلسلة النصية المعطاة.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">match?(str) → true or false
 
<syntaxhighlight lang="ruby">match?(str) → true or false
سطر 9: سطر 11:
 
==المعاملات==
 
==المعاملات==
 
===<code>str‎</code>===
 
===<code>str‎</code>===
سلسلة نصية.
+
سلسلة نصية يراد التحقق من مطابقتها مع التعبير النمطي المعطى.
 
===<code>pos‎</code>===
 
===<code>pos‎</code>===
 +
موضع بدء البحث والمطابقة.
  
==القيمة المُعادة==
+
==القيمة المعادة==
 +
تعاد القيمة <code>true</code> أو القيمة <code>false</code> بحسب ما إذا كان التعبير النمطي المعطى قد تطابق أم لا مع السلسلة النصية <code>str</code> دون تحديث المتغير ‎<code>$~</code>‎ والمتغيرات الأخرى ذات الصلة.
  
 
==أمثلة==
 
==أمثلة==
سطر 20: سطر 24:
 
/P.../.match?("Ruby")    #=> false
 
/P.../.match?("Ruby")    #=> false
 
$&                      #=> nil‎</syntaxhighlight>
 
$&                      #=> nil‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <code>[[Ruby/Regexp/match|match]]</code>: يُعيد  كائنًا من النوع <code>MatchData</code> يصف المطابقة، أو يعيد <code>nil</code> إذا لم يكن هناك تطابق. هذا يُكافئ استرداد قيمة المتغير الخاص <code>$~</code> بعد مطابقة عادية. في حال تمرير الوسيط الثاني،، فإنه يحدد الموضع في السلسلة النصية لبدء البحث.
+
* التابع <code>[[Ruby/Regexp/match|match]]</code>: يُعيد  كائنًا من النوع <code>MatchData</code> يصف المطابقة بين تعبير نمطي وسلسلة نصية.
* التابع <code>[[Ruby/Regexp/named_captures|named_captures]]</code>: يُعيد  قاموسًا (hash) يحتوي معلومات حول الالتقاطات المسماة (named captures) لتتعبير النمطي .
 
  
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-i-match-3F قسم التابع match?‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-i-match-3F قسم التابع match?‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 05:49، 4 ديسمبر 2018

يتحقق التابع match?‎ ما إذا كان التعبير النمطي المعطى قد تطابق (matched) أم لا دون تحديث المتغير ‎$~‎ والمتغيرات الأخرى ذات الصلة.

في حال إعطاء الوسيط الثاني، فسيحدد موضع بدء البحث والمطابقة في السلسلة النصية المعطاة.

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

match?(str)  true or false
match?(str,pos) true or false

المعاملات

str‎

سلسلة نصية يراد التحقق من مطابقتها مع التعبير النمطي المعطى.

pos‎

موضع بدء البحث والمطابقة.

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

تعاد القيمة true أو القيمة false بحسب ما إذا كان التعبير النمطي المعطى قد تطابق أم لا مع السلسلة النصية str دون تحديث المتغير ‎$~‎ والمتغيرات الأخرى ذات الصلة.

أمثلة

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

/R.../.match?("Ruby")    #=> true
/R.../.match?("Ruby", 1) #=> false
/P.../.match?("Ruby")    #=> false
$&                       #=> nil‎

انظر أيضًا

  • التابع match: يُعيد كائنًا من النوع MatchData يصف المطابقة بين تعبير نمطي وسلسلة نصية.

مصادر