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

(PHP 4, PHP 5, PHP 7)

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

الوصف

string strtoupper ( string $string )

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

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

المعاملات

string

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

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

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

أمثلة

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

<?php
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtoupper($str);
echo $str; // MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
?>

ملاحظات

هذه الدالة هي آمنة ثنائيًّا (binary safe).

انظر أيضًا

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

مصادر

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