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

من موسوعة حسوب
< Ruby‏ | Regexp
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>escape‎</code> الخاص بالصنف <code>Regexp</code> في روبي}}</noinclude> تصنيف: Ruby تصني...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Regexp]]
[[تصنيف: Ruby Regexp]]
يُخلّص (Escapes) التابع <code>escape</code> أي حرف يمكن أن يكون له معنى خاص في التعبير النمطي. ثم يعيد سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن الذي استُدعي معه (self) في حال عدم تخليص أي أحرف.  لكل سلسلة نصية str، ستكون قيمة <code>Regexp.new(Regexp.escape( str ))=~ str</code> مساوية للقيمة true.
يُخلّص (Escapes) التابع <code>escape</code> أي حرف يمكن أن يكون له معنى خاص في التعبير النمطي. ثم يعيد سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن الذي استُدعي معه (<code>self</code>) في حال عدم تخليص أي أحرف.   
 
لكل سلسلة نصية <code>str</code>، ستكون قيمة التعبير <code>Regexp.new(Regexp.escape( str ))=~ str</code> مساوية للقيمة <code>true</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">escape(str)→ string‎</syntaxhighlight>
<syntaxhighlight lang="ruby">escape(str)→ string‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>str‎</code>===
===<code>str‎</code>===
سلسلة نصية.


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


==أمثلة==
==أمثلة==
سطر 15: سطر 19:
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/Regexp/compile|compile]]</code>: اسم آخر للتابع <code>Regexp.new</code>
* التابع <code>[[Ruby/Regexp/last_match|last_match]]</code>: يُعيد   كائن <code>[[Ruby/MatchData|MatchData]]</code> الذي تم إنشاؤه من آخر تطابق ناجح للنمط.
* التابع <code>[[Ruby/Regexp/last_match|last_match]]</code>: يُعيد في الشكل الأول  كائن <code>[[Ruby/MatchData|MatchData]]</code> الذي تم إنشاؤه من آخر تطابق ناجح للنمط.  وهو مكافئ لقراءة المتغير العام المخصوص <code>$~</code> (راجع المتغيرات العامة المخصوصة في صفحة <code>[[Ruby/Regexp|Regexp]]</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‎ في توثيق روبي الرسمي.]

مراجعة 21:40، 31 أكتوبر 2018

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

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

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

escape(str) string

المعاملات

str‎

سلسلة نصية.

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

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

أمثلة

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

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

انظر أيضا

  • التابع last_match: يُعيد كائن MatchData الذي تم إنشاؤه من آخر تطابق ناجح للنمط.

مصادر