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

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


==القيمة المُعادة==
==القيمة المُعادة==
يُعيد سلسلة نصية جديدة مُخلّصة، أو يعيد الكائن الذي استُدعي معه إذا لم يتم تخليص أي أحرف. 


==أمثلة==
==أمثلة==
سطر 16: سطر 19:
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
<syntaxhighlight lang="ruby">Regexp.escape('\*?{}.')  #=> \\\*\?\{\}\.‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/Regexp/new|new]]</code>: ينشئ  تعبيرًا نمطيًا جديدًا من <code>pattern</code>، والذي يمكن أن يكون إما سلسلة نصية (<code>[[Ruby/String|String]]</code>) أو كائنًا من النوع <code>[[Ruby/Regexp|Regexp]]</code> (وفي هذه الحالة يتم نشر خيارات التعبير النمطي)، وقد لا يتم تحديد خيارات جديدة (منذ روبي 1.8).
* التابع <code>[[Ruby/Regexp/new|new]]</code>: ينشئ  تعبيرًا نمطيًا جديدًا.
* التابع <code>[[Ruby/Regexp/try_convert|try_convert]]</code>: يُحاول  تحويل الوسيط obj  إلى كائن من النوع <code>[[Ruby/Regexp|Regexp]]</code>، باستخدام التابع to_regexp. ثم يعيد التعبير النمطي الناتج، أو nil في حالة تعذر تحويل obj لسبب أو لآخر.
* التابع <code>[[Ruby/Regexp/escape|escape]]</code>: يُخلّص أي حرف يمكن أن يكون له معنى خاص في التعبير النمطي.


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

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

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

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

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

quote(str)  string

المعاملات

str‎

سلسلة نصية.

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

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

أمثلة

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

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

انظر أيضا

  • التابع new: ينشئ تعبيرًا نمطيًا جديدًا.
  • التابع escape: يُخلّص أي حرف يمكن أن يكون له معنى خاص في التعبير النمطي.

مصادر