التابع try_convert‎ الخاص بالصنف Regexp في روبي

يُحاول التابع try_convert تحويل الوسيط obj (انظر فقرة البنية العامة) إلى كائن من النوع Regexp، باستخدام التابع to_regexp. ثم يعيد التعبير النمطي الناتج، أو nil في حالة تعذر تحويل obj لسبب أو لآخر.

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

try_convert(obj) → re or nil‎

أمثلة

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

Regexp.try_convert(/re/)         #=> /re/
Regexp.try_convert("re")         #=> nil
o = Object.new
Regexp.try_convert(o)            #=> nil
def o.to_regexp() /foo/ end
Regexp.try_convert(o)            #=> /foo/‎

انظر أيضا

• التابع quote: يُخلّص (escapes) أي حرف قد يكون له معنى خاص في التعبير النمطي. ثم يُعيد سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن (self) إذا لم يتم تخليص أي أحرف. لكل سلسلة نصية str، ستكون قيمة التعبير Regexp.new(Regexp.escape( str ))=~ str مساوية للقيمة true.
• التابع union: يُعيد كائن من النوع Regexp، والذي يمثل اتحاد الأنماط المعطاة، أي أنه سيتطابق مع أي من أجزائه. يمكن أن تكون الأنماط كائنات من النوع Regexp، وفي هذه الحالة سيتم الاحتفاظ بخياراتها، أو يمكن أن تكون سلاسل نصية. إذا لم يتم إعطاء أية أنماط، فسيعيد القيمة /(?!)/. السلوك سيكون غير محدد إذا احتوى أيُّ من الأنماط المعطاة على التقاط (capture).

مصادر

• قسم التابع try_convert‎ في الصنف Regexp‎ في توثيق روبي الرسمي.