الفرق بين المراجعتين ل"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/quote|quote]]</code>: يُخلّص (escapes) التعبير النمطي
+
* التابع <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‎ في توثيق روبي الرسمي.]

مراجعة 14:19، 3 ديسمبر 2018

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

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

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

escape(str) string

المعاملات

str‎

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

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

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

أمثلة

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

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

انظر أيضًا

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

مصادر