الفرق بين المراجعتين لصفحة: «Ruby/Regexp/escape»

من موسوعة حسوب
< Ruby‏ | Regexp
لا ملخص تعديل
طلا ملخص تعديل
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>escape‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>Regexp.escape‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Regexp]]
[[تصنيف: Ruby Regexp]]
يُخلّص (Escapes) التابع <code>escape</code> أي حرف يمكن أن يكون له معنى خاص في التعبير النمطي. ثم يعيد سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن الذي استُدعي معه (<code>self</code>) في حال عدم تخليص أي أحرف.   
يهرِّب التابع <code>escape</code> أي محرف يمكن أن يكون له معنى خاص في التعبير النمطي ثم يعيد سلسلة نصية جديدة مهرَّبة، أو يعيد الكائن الذي استُدعي معه (<code>self</code>) في حال عدم تهريب أي محرف.   


لكل سلسلة نصية <code>str</code>، ستكون قيمة التعبير <code>Regexp.new(Regexp.escape( str ))=~ str</code> مساوية للقيمة <code>true</code>.
لكل سلسلة نصية <code>str</code>، ستكون قيمة التعبير <code>Regexp.new(Regexp.escape( str ))=~ str</code> مساوية للقيمة <code>true</code>.
سطر 10: سطر 10:
==المعاملات==
==المعاملات==
===<code>str‎</code>===
===<code>str‎</code>===
سلسلة نصية.
السلسلة النصية المراد تهريبها.


==القيمة المُعادة==
==القيمة المعادة==
يعيد التابع <code>escape</code> سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن الذي استُدعي معه (<code>self</code>) في حال عدم تخليص أي أحرف.   
تعاد سلسلة نصية جديدة مهرَّبة، أو يعاد الكائن الذي استُدعي معه (<code>self</code>) في حال عدم تهريب أي محارف.   


==أمثلة==
==أمثلة==
مثال على استخدام التابع <code>escape‎</code>:
مثال على استخدام التابع <code>escape‎</code>:
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/Regexp/last_match|last_match]]</code>: يُعيد    كائن <code>[[Ruby/MatchData|MatchData]]</code> الذي تم إنشاؤه من آخر تطابق ناجح للنمط.
* التابع <code>[[Ruby/Regexp/quote|quote]]</code>: يهرِّب التعبير النمطي.


==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-c-escape قسم التابع escape‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Regexp.html#method-c-escape قسم التابع escape‎ في الصنف Regexp‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 05:42، 4 ديسمبر 2018

يهرِّب التابع escape أي محرف يمكن أن يكون له معنى خاص في التعبير النمطي ثم يعيد سلسلة نصية جديدة مهرَّبة، أو يعيد الكائن الذي استُدعي معه (self) في حال عدم تهريب أي محرف.

لكل سلسلة نصية str، ستكون قيمة التعبير Regexp.new(Regexp.escape( str ))=~ str مساوية للقيمة true.

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

escape(str) string

المعاملات

str‎

السلسلة النصية المراد تهريبها.

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

تعاد سلسلة نصية جديدة مهرَّبة، أو يعاد الكائن الذي استُدعي معه (self) في حال عدم تهريب أي محارف.

أمثلة

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

Regexp.escape('\*?{}.')   #=> \\\*\?\{\}\.‎

انظر أيضًا

  • التابع quote: يهرِّب التعبير النمطي.

مصادر