الفرق بين المراجعتين لصفحة: «Ruby/String/chomp»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) إضافة المحتوى |
||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يعيد التابع <code>chomp</code> | يعيد التابع <code>chomp</code> نسخة عن السلسلة النصية مع حذف الفاصل السطري المُحدد من نهايتها (إن كان موجودًا). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">chomp(separator=$/) → new_str</syntaxhighlight> | <syntaxhighlight lang="ruby">chomp(separator=$/) → new_str</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>separator</code> === | |||
الفاصل الذي سيُحذف من نهاية السلسلة النصية الجديدة. القيمة الافتراضية هي: <code>/$</code>. إن لم يغيَّر الفاصل <code>/$</code> من سجل الفاصل الافتراضي لروبي، فسيحذف التابع <code>chomp</code> محارف العودة إلى بداية السطر أيضًا (أي سيحذف المحارف <code>n\</code>، و <code>r\</code>، و <code>r\n\</code>). أمَّا إن كان هذا المعامل سلسلة نصية فارغة، فسيحذف التابع جميع محارف الأسطر الجديدة الزائدة من السلسلة النصية. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تُعاد نسخة عن السلسلة النصية مع حذف الفاصل <code>separator</code> المُحدد من نهايتها. | |||
==أمثلة== | ==أمثلة== | ||
سطر 21: | سطر 26: | ||
"hello\r\n\r\n".chomp('') #=> "hello" | "hello\r\n\r\n".chomp('') #=> "hello" | ||
"hello\r\n\r\r\n".chomp('') #=> "hello\r\n\r"</syntaxhighlight> | "hello\r\n\r\r\n".chomp('') #=> "hello\r\n\r"</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/chomp-21|chomp!]]</code>: يحذف الفاصل السطري المُحدد من نهاية السلسلة النصية المعطاة، أو يعيد القيمة <code>nil</code> إن لم يجري أي تعديل عليها. | |||
* التابع <code>[[Ruby/String/chop|chop]]</code>: يعيد نسخةً عن السلسلة النصية مع حذف المحرف الأخير منها. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-chomp قسم التابع chomp في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-chomp قسم التابع chomp في الصنف String في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 06:20، 12 ديسمبر 2018
يعيد التابع chomp
نسخة عن السلسلة النصية مع حذف الفاصل السطري المُحدد من نهايتها (إن كان موجودًا).
البنية العامة
chomp(separator=$/) → new_str
المعاملات
separator
الفاصل الذي سيُحذف من نهاية السلسلة النصية الجديدة. القيمة الافتراضية هي: /$
. إن لم يغيَّر الفاصل /$
من سجل الفاصل الافتراضي لروبي، فسيحذف التابع chomp
محارف العودة إلى بداية السطر أيضًا (أي سيحذف المحارف n\
، و r\
، و r\n\
). أمَّا إن كان هذا المعامل سلسلة نصية فارغة، فسيحذف التابع جميع محارف الأسطر الجديدة الزائدة من السلسلة النصية.
القيمة المعادة
تُعاد نسخة عن السلسلة النصية مع حذف الفاصل separator
المُحدد من نهايتها.
أمثلة
مثال على استخدام التابع chomp
:
"hello".chomp #=> "hello"
"hello\n".chomp #=> "hello"
"hello\r\n".chomp #=> "hello"
"hello\n\r".chomp #=> "hello\n"
"hello\r".chomp #=> "hello"
"hello \n there".chomp #=> "hello \n there"
"hello".chomp("llo") #=> "he"
"hello\r\n\r\n".chomp('') #=> "hello"
"hello\r\n\r\r\n".chomp('') #=> "hello\r\n\r"
انظر أيضًا
- التابع
chomp!
: يحذف الفاصل السطري المُحدد من نهاية السلسلة النصية المعطاة، أو يعيد القيمةnil
إن لم يجري أي تعديل عليها. - التابع
chop
: يعيد نسخةً عن السلسلة النصية مع حذف المحرف الأخير منها.