عرض مصدر Ruby/String/squeeze

<noinclude>{{DISPLAYTITLE:التابع <code>String.squeeze</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby String]]
يعيد التابع <code>squeeze</code> نسخة عن السلسلة النصية التي استدعي معها مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها. يمكن تحديد المحارف المراد إزالة تكرارها دون غيرها عبر تمريرها إلى التابع.
==البنية العامة==
<syntaxhighlight lang="ruby">squeeze([other_str]*) → new_str</syntaxhighlight>

== المعاملات ==
<code>other_str</code>

تحدد السلسلة <code>other_str</code> مجموعة المحارف المُراد إزالة تكرارها من نسخة السلسلة النصية المُعطاة. عند استعمال الرمز <code>^</code> في بداية السلسلة <code>other_str</code>، فإن التابع يشمل جميع المحارف عدا محارف تلك السلسلة. الصيغة <code>c1-c2</code> تعني جميع المحارف الواقعة في المجال بين <code>c1</code> و <code>c2</code>. يُستعمل الخط المائل العكسي <code>\</code> لتهريب الرمزين <code>^</code> و <code>-</code>، ولا يتم حسابه إلا إذا وقع في نهاية مجال، أو في نهاية السلسلة <code>other_str</code>.

==القيمة المعادة==
تُعاد نسخة عن السلسلة النصية مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها. يمكن استعمال المعامل <code>other_str</code> لتحديد مجموعة المحارف المُراد إزالة تكرارها دون غيرها. 

==أمثلة==
مثال على استعمال التابع <code>squeeze</code>:
<syntaxhighlight lang="ruby">"yellow moon".squeeze                  #=> "yelow mon"
"  now   is  the".squeeze(" ")         #=> " now is the"
"putters shoot balls".squeeze("m-z")   #=> "puters shot balls"</syntaxhighlight>

==انظر أيضًا==
* التابع <code>[[Ruby/String/partition|partition]]</code>: يبحث عن تطابق نص أو نمط محدد ضمن السلسلة النصية التي استدعي معها.

* التابع <code>[[Ruby/String/rstrip|rstrip]]</code>: يعيد نسخة عن السلسلة النصية التي استدعي معها مع حذف المسافات البيضاء من نهايتها.

* التابع <code>[[Ruby/String/slice|slice]]</code>: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

* التابع <code>[[Ruby/String/squeeze-21|squeeze!‎]]</code>: يستبدل المحارف المكررة على التوالي فى السلسلة النصية بمحرف واحد لكل منها.

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