الفرق بين المراجعتين ل"Ruby/String/capitalize-21"

من موسوعة حسوب
< Ruby‏ | String
اذهب إلى التنقل اذهب إلى البحث
(إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال".)
 
(إضافة المحتوى)
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby String]]
 
[[تصنيف: Ruby String]]
يعيد التابع <code>capitalize!‎</code> ب
+
يُعدل التابع <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?‎: يتحقق إذا كانت السلسلة النصية التي استدعيت معه متساوية مع السلسلة المُمرَّرة إليه دون أخذ حالة المحارف بالحسبان.

مصادر