PHP/array change key case

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

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

الوصف

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

المعاملات

array

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

case

حالة الأحرف اللاتينية. إما كبيرة CASE_UPPER أو صغيرة CASE_LOWER (الحالة الافتراضية). 

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

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

الأخطاء والاستثناءات

ترمي الدالة خطأً من النوع E_WARNING إذا كانت المصفوفة array فارغة.

أمثلة

المثال 1: مثال بسيط عن استخدام الدالة array_change_key_case()‎

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

نتيجة المثال السابق:

Array
(
    [FIRST] => 1
    [SECOND] => 4
)

ملاحظات

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

المصادر

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