الفرق بين المراجعتين لصفحة: «Ruby/String/delete-21»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) إضافة المحتوى |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يحذف التابع <code>delete!</code> محارف السلسلة النصية المُمرَّرة إليه من السلسلة النصية التي استدعي معها. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">delete!([other_str]+) → str or nil</syntaxhighlight> | <syntaxhighlight lang="ruby">delete!([other_str]+) → str or nil</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>other_str</code> === | |||
السلسلة المُراد حذف حروفها من نسخة السلسلة النصية المُعطاة. في حال إضافة أكثر من سلسلة نصية، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها المحارف المتقاطعة لتلك السلاسل النصية المعطاة. | |||
عند استعمال الرمز <code>^</code> في بداية السلسلة <code>other_str</code>، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها جميع المحارف عدا محارف السلسلة <code>other_str</code> تلك. الصيغة <code>c1-c2</code> تعني جميع الحروف الواقعة في المجال بين <code>c1</code> و <code>c2</code>. | |||
يُستعمل الخط المائل العكسي <code>\</code> لتهريب الرمزين <code>^</code> و <code>-</code>، ولا يُحذَف من نسخة السلسلة <code>str</code> إلا إذا وقع في نهاية مجال، أو في نهاية السلسلة <code>other_str</code>. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تُعاد السلسلة النصية المُعطاة نفسها بعد حذف محارف السلسلة <code>other_str</code> منها. ستُعاد القيمة <code>nil</code> في حال عدم إجراء أي تعديل على السلسلة النصية. | |||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/delete|delete]]</code>: يعيد نسخة عن السلسلة النصية المُعطاة محذوفًا منها محارف السلسلة النصية المُمرَّرة إليه. | |||
* التابع <code>[[Ruby/String/delete prefix-21|delete_prefix!]]</code>: يحذف سابقة محددة من السلسلة النصية المعطاة. | |||
* التابع <code>[[Ruby/String/delete suffix-21|delete_suffix!]]</code>: يحذف لاحقة محددة من السلسلة النصية التي استدعي معها. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-delete-21 قسم التابع delete! في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-delete-21 قسم التابع delete! في الصنف String في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:30، 12 ديسمبر 2018
يحذف التابع delete! محارف السلسلة النصية المُمرَّرة إليه من السلسلة النصية التي استدعي معها.
البنية العامة
delete!([other_str]+) → str or nil
المعاملات
other_str
السلسلة المُراد حذف حروفها من نسخة السلسلة النصية المُعطاة. في حال إضافة أكثر من سلسلة نصية، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها المحارف المتقاطعة لتلك السلاسل النصية المعطاة.
عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يعيد نسخة عن السلسلة المعطاة محذوفًا منها جميع المحارف عدا محارف السلسلة other_str تلك. الصيغة c1-c2 تعني جميع الحروف الواقعة في المجال بين c1 و c2.
يُستعمل الخط المائل العكسي \ لتهريب الرمزين ^ و -، ولا يُحذَف من نسخة السلسلة str إلا إذا وقع في نهاية مجال، أو في نهاية السلسلة other_str.
القيمة المعادة
تُعاد السلسلة النصية المُعطاة نفسها بعد حذف محارف السلسلة other_str منها. ستُعاد القيمة nil في حال عدم إجراء أي تعديل على السلسلة النصية.
انظر أيضًا
- التابع
delete: يعيد نسخة عن السلسلة النصية المُعطاة محذوفًا منها محارف السلسلة النصية المُمرَّرة إليه. - التابع
delete_prefix!: يحذف سابقة محددة من السلسلة النصية المعطاة. - التابع
delete_suffix!: يحذف لاحقة محددة من السلسلة النصية التي استدعي معها.