المعامل ~= الخاص بالصنف String في روبي

من موسوعة حسوب
< Ruby‏ | 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

انظر أيضًا

  • المعامل +: يجمع سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة.
  • المعامل >>: يُلحق الكائن المُعطى بالسلسلة النصية.

مصادر