الفرق بين المراجعتين لصفحة: «Ruby/String/capitalize-21»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) إضافة المحتوى |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يُعدل التابع <code>!capitalize</code> السلسلة النصية بتحويل الحرف الأول إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة، أو يعيد القيمة <code>nil</code> في حال عدم إجراء أي تعديل. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">capitalize! → str or nil | <syntaxhighlight lang="ruby">capitalize! → str or nil | ||
capitalize!([options]) → str or nil</syntaxhighlight> | capitalize!([options]) → str or nil</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>options</code> === | |||
الخيارات التي تتحكم في الترميز وعملية التحويل. انتقل إلى صفحة التابع <code>[[Ruby/String/downcase|downcase]]</code> للاطلاع على شرح الخيارات الأربعة - <code>ascii:</code>، و <code>turkic:</code>، و <code>lithuanian:</code>، و <code>fold:</code> - التي يمكن استعمالها مع هذا المعامل. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تُعاد السلسلة النصية المعطاة نفسها بعد تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة، أو تُعاد القيمة <code>nil</code> عند عدم إجراء أي تعديل على السلسلة. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 17: | سطر 22: | ||
a #=> "Hello" | a #=> "Hello" | ||
a.capitalize! #=> nil</syntaxhighlight> | a.capitalize! #=> nil</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/capitalize|capitalize]]</code>: يعيد نسخة عن السلسلة النصية المعطاة مع تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة. | |||
* التابع <code>[[Ruby/String/casecmp-3F|casecmp?]]</code>: يتحقق إذا كانت السلسلة النصية التي استدعيت معه متساوية مع السلسلة المُمرَّرة إليه دون أخذ حالة المحارف بالحسبان. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-capitalize-21 قسم التابع capitalize! في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-capitalize-21 قسم التابع capitalize! في الصنف String في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 04:35، 12 ديسمبر 2018
يُعدل التابع !capitalize السلسلة النصية بتحويل الحرف الأول إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة، أو يعيد القيمة nil في حال عدم إجراء أي تعديل.
البنية العامة
capitalize! → str or nil
capitalize!([options]) → str or nil
المعاملات
options
الخيارات التي تتحكم في الترميز وعملية التحويل. انتقل إلى صفحة التابع downcase للاطلاع على شرح الخيارات الأربعة - ascii:، و turkic:، و lithuanian:، و fold: - التي يمكن استعمالها مع هذا المعامل.
القيمة المعادة
تُعاد السلسلة النصية المعطاة نفسها بعد تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة، أو تُعاد القيمة nil عند عدم إجراء أي تعديل على السلسلة.
أمثلة
مثال على استخدام التابع capitalize!:
a = "hello"
a.capitalize! #=> "Hello"
a #=> "Hello"
a.capitalize! #=> nil
انظر أيضًا
- التابع
capitalize: يعيد نسخة عن السلسلة النصية المعطاة مع تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة. - التابع
casecmp?: يتحقق إذا كانت السلسلة النصية التي استدعيت معه متساوية مع السلسلة المُمرَّرة إليه دون أخذ حالة المحارف بالحسبان.