الدالة ucfirst()‎ في PHP

من موسوعة حسوب
< PHP
مراجعة 11:05، 8 أبريل 2018 بواسطة عبد اللطيف ايمش (نقاش | مساهمات) (تصحيح التصنيفات)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

(PHP 4, PHP 5, PHP 7)

تحوِّل الدالة ucfirst()‎ الحرف الأول للسلسلة النصيَّة الممرَّرة إليها إلى حرف كبير (uppercase).

الوصف

string ucfirst ( string $str )

تعيد هذه الدالة السلسلة النصيَّة str بعد أن تحوِّل الحرف الأول لها إلى حرف كبير، إن كان هذا الحرف هو حرف أبجدي بالتأكيد.

لاحظ أنَّ الحروف الأبجدية تُحدَّد باستعمال المحليَّة (locale) الحاليَّة. بعبارة أخرى، لن تُحوَّل الحروف الشبيه بالحرف ä في المحليَّة "C" الافتراضيَّة.

يجدر بالذكر أنَّ هذه الدالة لا تجري أيّ تعديلات على النصوص العربيَّة.

المعاملات

str

السلسلة النصيَّة المراد تبديل حالة حرفها الأول إلى حرف كبير.

القيم المعادة

تُعاد السلسلة النصيَّة str بعد تحويل حرفها الأول إلى حرف كبير.

أمثلة

المثال 1: استعمال الدالة ucfirst()‎

<?php
$foo = 'hello world!';
$foo = ucfirst($foo);             // Hello world!

$bar = 'HELLO WORLD!';
$bar = ucfirst($bar);             // HELLO WORLD!
$bar = ucfirst(strtolower($bar)); // Hello world!
?>

انظر أيضًا

  • الدالة lcfirst()‎: تحوِّل الحرف الأول للسلسلة النصيَّة الممرَّرة إليها إلى حرف صغير.
  • الدالة strtoupper()‎: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف كبيرة.
  • الدالة strtolower()‎: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف صغيرة.
  • الدالة ucwords()‎: تحوِّل الحرف الأول من كل كلمة من كلمات السلسلة النصيَّة إلى حرف كبير.

مصادر