عرض مصدر PHP/strtoupper

<noinclude>{{DISPLAYTITLE:الدالة <code>strtoupper()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

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

== الوصف ==
<syntaxhighlight lang="php">
string strtoupper ( string $string )
</syntaxhighlight>تعيد هذه الدالة السلسلة النصيَّة <code>string</code> بعد تحويل جميع حروفها الأبجدية إلى أحرف كبيرة.

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

== المعاملات ==

=== <code>string</code> ===
السلسلة النصيَّة المراد تبديل حالة حرفها إلى حالة الأحرف الكبيرة.

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

== أمثلة ==
المثال 1: استعمال الدالة <code>strtoupper()‎</code><syntaxhighlight lang="php">
<?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
?>
</syntaxhighlight>

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

== انظر أيضًا ==
* الدالة <code>[[PHP/strtolower|strtolower()‎]]</code>: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف صغيرة.
* الدالة <code>[[PHP/ucfirst|ucfirst()‎]]</code>: تحوِّل الحرف الأول للسلسلة النصيَّة المُمرَّرة إليها إلى حرف كبير.
* الدالة <code>[[PHP/ucwords|ucwords()‎]]</code>: تحوِّل الحروف الأولى من كل كلمة من كلمات السلسلة النصيَّة المُمرَّرة إليها إلى أحرف كبيرة.
* الدالة <code>[[PHP/mb-strtoupper|mb_strtoupper()‎]]</code>: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف صغيرة.

== مصادر ==
* [http://php.net/manual/en/function.strtoupper.php صفحة الدالة strtoupper في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP String]]