الفرق بين المراجعتين لصفحة: «PHP/ucfirst»

من موسوعة حسوب
< PHP
إضافة محتويات الصفحة.
 
ط تصحيح التصنيفات
 
سطر 42: سطر 42:
* [http://php.net/manual/en/function.ucfirst.php صفحة الدالة ucfirst في توثيق PHP الرسمي.]
* [http://php.net/manual/en/function.ucfirst.php صفحة الدالة ucfirst في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP String]]
[[تصنيف:PHP String]]

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

مصادر