المعامل ~=
الخاص بالصنف 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
انظر أيضًا
- المعامل
+
: يجمع سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة. - المعامل
>>
: يُلحق الكائن المُعطى بالسلسلة النصية.