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

(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()‎: تحوِّل الحرف الأول من كل كلمة من كلمات السلسلة النصيَّة إلى حرف كبير.

مصادر

• صفحة الدالة ucfirst في توثيق PHP الرسمي.