عرض مصدر PHP/array change key case

<noinclude>{{DISPLAYTITLE:<code>()array_change_key_case</code>}}</noinclude>
(PHP 4 >= 4.2.0, PHP 5, PHP 7)

تغير الدالة <code>array_change_key_case()‎</code> حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة.

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

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

=== array ===
المصفوفة التي ستعمل عليها الدالة.

=== case ===
حالة الأحرف اللاتينية. إما كبيرة <code>CASE_UPPER</code> أو صغيرة <code>CASE_LOWER</code> (الحالة الافتراضية). 

== القيم المعادة ==
تعيد هذه الدالة مصفوفةً تحتوي على مفاتيحٍ قد حُوِّلَت حالة أحرفها إلى الحالة  الكبيرة أو الصغيرة، أو القيمة <code>false</code> إذا لم يكن نوع المعامل مصفوفةً. 

== الأخطاء والاستثناءات ==
ترمي الدالة خطأً من النوع <code>E_WARNING</code> إذا كانت المصفوفة <code>array</code> فارغة.

== أمثلة ==
المثال 1: مثال بسيط عن استخدام الدالة <code>array_change_key_case()‎</code><syntaxhighlight lang="php" start="1">

<?php
$input_array = array("FirSt" => 1, "SecOnd" => 4);
print_r(array_change_key_case($input_array, CASE_UPPER));
?>


</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="php">
Array
(
    [FIRST] => 1
    [SECOND] => 4
)
</syntaxhighlight>

== ملاحظات ==
إذا احتوت المصفوفات على فهارس متماثلة بالنسبة لهذه الدالة، فإن القيمة التالية سوف تحل محل القيمة السابقة لها و المسجلة مع نفس المفتاح.

== المصادر ==
* [http://php.net/manual/en/function.array-change-key-case.php صفحة array_change_key_case من توثيق PHP الرسمي.]