الفرق بين المراجعتين لصفحة: «Ruby/String/match-3F»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يحول التابع <code>match?</code> النمط المُمرَّر إليه إلى [[Ruby/Regexp|تعبير نمطي]] (إن لم يكن كذلك) ثم يتحقق من مطابقته من السلسلة النصية التي استدعي معها دون تحديث قيمة المتغير <code>~$</code> والمتغيرات الأخرى المماثلة. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">match?(pattern) → true or false | <syntaxhighlight lang="ruby">match?(pattern) → true or false | ||
match?(pattern, pos) → true or false</syntaxhighlight> | match?(pattern, pos) → true or false</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>pattern</code> === | |||
[[Ruby/Regexp|التعبير النمطي]] المراد مطابقته للسلسلة النصية المعطاة. إن يكن [[Ruby/Regexp|تعبيرًا نمطيًّا]]، فسيُحوَّل النمط المعطى إلى [[Ruby/Regexp|تعبير نمطي]]. | |||
=== <code>pos</code> === | |||
إن أعطي هذا المعامل الاختياري، فسيُحدِّد موضع بدء عملية المطابقة في السلسلة النصية المعطاة. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تعاد القيمة <code>true</code> إن طابق التعبير النمطي <code>pattern</code> السلسلة النصية المعطاة دون تحديث قيمة المتغير <code>~$</code> والمتغيرات الأخرى المماثلة. خلا ذلك، تعاد القيمة <code>false</code>. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 18: | سطر 26: | ||
$& #=> nil</syntaxhighlight> | $& #=> nil</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/match|match]]</code>: يحول النمط المُمرَّر إليه إلى [[Ruby/Regexp|تعبير نمطي]] (إن لم يكن كذلك) ثم يطابقه مع السلسلة النصية التي استدعيت معه. | |||
* التابع <code>[[Ruby/String/gsub-21|gsub!]]</code>: يبدل قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة في السلسلة النصية التي استدعي معها. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-match-3F قسم التابع match? في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-match-3F قسم التابع match? في الصنف String في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 11:21، 26 مارس 2019
يحول التابع match? النمط المُمرَّر إليه إلى تعبير نمطي (إن لم يكن كذلك) ثم يتحقق من مطابقته من السلسلة النصية التي استدعي معها دون تحديث قيمة المتغير ~$ والمتغيرات الأخرى المماثلة.
البنية العامة
match?(pattern) → true or false
match?(pattern, pos) → true or false
المعاملات
pattern
التعبير النمطي المراد مطابقته للسلسلة النصية المعطاة. إن يكن تعبيرًا نمطيًّا، فسيُحوَّل النمط المعطى إلى تعبير نمطي.
pos
إن أعطي هذا المعامل الاختياري، فسيُحدِّد موضع بدء عملية المطابقة في السلسلة النصية المعطاة.
القيمة المعادة
تعاد القيمة true إن طابق التعبير النمطي pattern السلسلة النصية المعطاة دون تحديث قيمة المتغير ~$ والمتغيرات الأخرى المماثلة. خلا ذلك، تعاد القيمة false.
أمثلة
مثال على استعمال التابع match?:
"Ruby".match?(/R.../) #=> true
"Ruby".match?(/R.../, 1) #=> false
"Ruby".match?(/P.../) #=> false
$& #=> nil
انظر أيضًا
- التابع
match: يحول النمط المُمرَّر إليه إلى تعبير نمطي (إن لم يكن كذلك) ثم يطابقه مع السلسلة النصية التي استدعيت معه. - التابع
gsub!: يبدل قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة في السلسلة النصية التي استدعي معها.