الفرق بين المراجعتين لصفحة: «PHP/array change key case»
ط إضافة عنوان الصفحة |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-change-key-case إلى PHP/array change key case: إعادة هيكلة التوثيق |
||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>() | <noinclude>{{DISPLAYTITLE:<code>array_chagne_key_case()</code>}}</noinclude> | ||
(PHP 4 >= 4.2.0, PHP 5, PHP 7) | (PHP 4 >= 4.2.0, PHP 5, PHP 7) | ||
تغير الدالة array_change_key_case() حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة. | تغير الدالة <code>array_change_key_case()</code> حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة. | ||
== الوصف == | == الوصف == | ||
| سطر 8: | سطر 8: | ||
== المعاملات == | == المعاملات == | ||
=== array === | |||
المصفوفة التي ستعمل عليها الدالة. | المصفوفة التي ستعمل عليها الدالة. | ||
case | === case === | ||
حالة الأحرف اللاتينية. إما كبيرة <code>CASE_UPPER</code> أو صغيرة <code>CASE_LOWER</code> (الحالة الافتراضية). | |||
== القيم المعادة == | |||
تعيد هذه الدالة مصفوفةً تحتوي على مفاتيحٍ قد حُوِّلَت حالة أحرفها إلى الحالة الكبيرة أو الصغيرة، أو القيمة <code>false</code> إذا لم يكن نوع المعامل مصفوفةً. | |||
== القيم | |||
تعيد هذه الدالة مصفوفةً تحتوي على مفاتيحٍ قد حُوِّلَت حالة أحرفها إلى الحالة الكبيرة أو الصغيرة، أو القيمة | |||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
ترمي الدالة خطأً من النوع E_WARNING إذا كانت المصفوفة array فارغة. | ترمي الدالة خطأً من النوع <code>E_WARNING</code> إذا كانت المصفوفة <code>array</code> فارغة. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال بسيط عن استخدام الدالة <code>array_change_key_case()</code><syntaxhighlight lang="php" start="1"> | |||
<?php | <?php | ||
$input_array = array("FirSt" => 1, "SecOnd" => 4); | $input_array = array("FirSt" => 1, "SecOnd" => 4); | ||
print_r(array_change_key_case($input_array, CASE_UPPER)); | |||
?> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
نتيجة المثال السابق:<syntaxhighlight lang="php"> | نتيجة المثال السابق:<syntaxhighlight lang="php"> | ||
Array | Array | ||
( | ( | ||
[FIRST] => 1 | |||
[SECOND] => 4 | |||
) | ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 50: | سطر 45: | ||
== المصادر == | == المصادر == | ||
* [http://php.net/manual/en/function.array-change-key-case.php صفحة array_change_key_case من توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.array-change-key-case.php صفحة array_change_key_case من توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Array]] | |||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(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
)
ملاحظات
إذا احتوت المصفوفات على فهارس متماثلة بالنسبة لهذه الدالة، فإن القيمة التالية سوف تحل محل القيمة السابقة لها و المسجلة مع نفس المفتاح.