التابع Regexp.union‎ في روبي

يُعيد التابع union كائنًا من النوع Regexp، والذي يمثل اتحاد الأنماط المعطاة؛ أي أنه سيتطابق مع أي من تلك الأجزاء. يمكن أن تكون الأنماط المعطاة كائنات من النوع Regexp، وفي هذه الحالة سيتم الاحتفاظ بخياراتها، أو يمكن أن تكون سلاسل نصية.

إذا لم يتم إعطاء أية أنماط، فسيعيد التابع union القيمة /(‎?!‎)/. السلوك سيكون غير محدد إذا احتوى أيُّ من الأنماط المعطاة على التقاط (capture).

ملاحظة: ستحاول روبي تحويل المعاملات المُمررة للتابع union إلى تعبيرات نمطية حرفية ( regular expression literal) عبر التابع to_regexp.

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

union(pat1, pat2, ...)→ new_regexp
union(pats_ary) → new_regexp‎

المعاملات

pat1‎

النمط الأول.

pat2‎

النمط الثاني.

...‎

أنماط أخرى.

القيمة المعادة

يعاد كائنٌ من النوع Regexp يمثل اتحاد الأنماط المعطاة.

أمثلة

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

Regexp.union                         #=> /(?!)/
Regexp.union("penzance")             #=> /penzance/
Regexp.union("a+b*c")                #=> /a\+b\*c/
Regexp.union("skiing", "sledding")   #=> /skiing|sledding/
Regexp.union(["skiing", "sledding"]) #=> /skiing|sledding/
Regexp.union(/dogs/, /cats/i)        #=> /(?-mix:dogs)|(?i-mx:cats)/‎

انظر أيضًا

• التابع try_convert: يُحاول تحويل الكائن المُمرَّر إليه إلى كائن من النوع Regexp،

مصادر

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