array_flip()‎

(PHP 4, PHP 5, PHP 7)

تستبدل الدالة array_flip()‎ كل مفاتيح المصفوفة بالقيم المرتبطة معها.

الوصف

array array_flip ( array $array )

تعيد الدالة array_flip()‎ المصفوفة مقلوبة؛ تتحول مفاتيح المصفوفة إلي قيم وقيم المصفوفة إلى مفاتيح.

لاحظ أن قيم المعامل array يجب أن تكون صالحةً كمفاتيح؛ أي أنها أعداد صحيحة أو نصوص. ستصدر الدالة تحذيراً إذا لم تكن القيمة صحيحةً، ولن تدرج الدالة زوج المفتاح/القيمة المتسبب في التحذير في المصفوفة المعادة.

المعاملات

array

مصفوفة من أزواج المفاتيح والقيم لتبدِّل بينها الدالة.

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

تعاد المصفوفة بعد التعديل في حالة النجاح، أو NULL في حالة الفشل في إجراء التحويل.

أمثلة

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

<?php
$input = array("oranges", "apples", "pears");
$flipped = array_flip($input);

print_r($flipped);
?>

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

Array
(
    [oranges] => 0
    [apples] => 1
    [pears] => 2
)

المثال 2:  حالة حدوث اصطدام وتعارض بين القيم

<?php
$input = array("a" => 1, "b" => 1, "c" => 2);
$flipped = array_flip($input);

print_r($flipped);
?>

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

Array
(
    [1] => b
    [2] => c
)

انظر أيضًا

• الدالة array_values()‎: تعيد كل قيم المصفوفة.
• الدالة array_keys()‎: تعيد كل مفاتيح المصفوفة أو جزءًا منها.
• الدالة array_reverse()‎: تعيد المصفوفة وكل عناصرها معكوسة الترتيب.

مصادر

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