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

ينشئ التابع new تعبيرًا نظاميًّا جديدًا من النمط المُمرَّر إليه، والذي يمكن أن يكون إما سلسلة نصية أو كائنًا من النوع Regexp (وفي هذه الحالة يتم نشر خيارات التعبير النظامي)؛ وقد لا يتم تحديد الخيارات الجديدة (منذ روبي 1.8).

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

new(string, [options]) → regexp
new(regexp)→ regexp
compile(string, [options])→ regexp
compile(regexp)  → regexp‎

المعاملات

string‎

سلسلة نصية.

options‎

الخيارات التي تتحكم بالتعبير النظامي. إن كان المعامل options عددًا صحيحًا، فيجب أن يساوي واحدًا أو أكثر من الثوابت التالية: Regexp::EXTENDED أو Regexp::IGNORECASE أو Regexp::MULTILINE، أو كلها. وإلا، إن لم تكن قيمة options مساوية للقيمة nil أو false، فلن يكون التعبير النظامي حساسًا لحالة الأحرف.

regexp‎

تعبير نظامي.

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

يعاد تعبيرٌ نظامي جديد.

أمثلة

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

r1 = Regexp.new('^a-z+:\\s+\w+') #=> /^a-z+:\s+\w+/
r2 = Regexp.new('cat', true)     #=> /cat/i
r3 = Regexp.new(r2)              #=> /cat/i
r4 = Regexp.new('dog', Regexp::EXTENDED | Regexp::IGNORECASE) #=> /dog/ix‎

انظر أيضًا

• التابع compile: ينشئ تعبيرًا نظاميًّا جديدًا.
• التابع last_match: يُعيد إن لم يمرَّر إليه أي شيء كائنًا من النوع MatchData الذي تم إنشاؤه من آخر تطابق (match) ناجح للنمط.

مصادر

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