المعامل ~= الخاص بالصنف String في روبي
اذهب إلى التنقل
اذهب إلى البحث
يطابق المعامل ~= الكائن المُعطى مع سلسلة نصية. إذا كان الكائن عبارة عن تعبير نمطي (Regexp)، فإن المعامل يستعمله كنمط لمطابقة السلسلة النصية، ثم يعيد فهرس أول تطابق يعثر عليه، أو يعيد القيمة nil فى حال عدم وجود تطابق. عدا ذلك، فإنَّ المعامل يستدعي الكائن المعطى، ويمرر السلسلة النصية إليه كمعامل.
ملاحظة: الصيغة str =~ regexp ليست مثل regexp =~ str، حيث تُعين السلاسل الملتقطة من مجموعات الالتقاط المسماة إلى المتغيرات المحلية فى الحالة الثانية فقط.
البنية العامة
str =~ obj → integer or nil
المعاملات
str
السلسلة النصية المراد التحقق من مطابقتها.
obj
كائن من النوع Regexp سيُتحقق من تطابقه مع السلسلة النصية str.
القيمة المعادة
يُعاد عدد صحيح يمثِّل فهرس أول تطابق يعثر عليه المعامل، أو تُعاد القيمة nil فى حال عدم وجود تطابق.
أمثلة
مثال على استخدام المعامل ~=:
"cat o' 9 tails" =~ /\d/ #=> 7
"cat o' 9 tails" =~ 9 #=> nil
انظر أيضًا
- المعامل
+: يجمع سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة. - المعامل
>>: يُلحق الكائن المُعطى بالسلسلة النصية.