التابع String.capitalize!‎ في روبي

من موسوعة حسوب
< Ruby‏ | String

يُعدل التابع !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?‎: يتحقق إذا كانت السلسلة النصية التي استدعيت معه متساوية مع السلسلة المُمرَّرة إليه دون أخذ حالة المحارف بالحسبان.

مصادر