array_combine()‎

(PHP 5, PHP 7)

تنشئ الدالة array_combine()‎ مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى.

الوصف

array array_combine ( array $keys , array $values )

تنشئ الدالة مصفوفة جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل keys كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل values كقيم مرتبطة بهذه المفاتيح.

المعاملات

keys

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

values

مصفوفة من القيم تربط الدالة بينها وبين المفاتيح.

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

تعيد الدالة مصفوفة جديدة ناتجة عن دمج مصفوفتي المفاتيح والقيم، وتعيد FALSE إذا كان عدد العناصر فى المصفوفتين غير متساوٍ.

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

ترمي الدالة خطأ من نوع E_WARNING إذا كان عدد العناصر في مصفوفتي القيم والمفاتيح غير متساوٍ.

سجل التغييرات

الإصدار	الوصف
5.4.0	أصدرت النسخ السابقة خطأً من نوع E_WARNING وأعادت FALSE إذا كانت المصفوفات الفارغة.

أمثلة

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

<?php
$a = array('green', 'red', 'yellow');
$b = array('avocado', 'apple', 'banana');
$c = array_combine($a, $b);

print_r($c);
?>

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

Array
(
    [green]  => avocado
    [red]    => apple
    [yellow] => banana
)

انظر أيضًا

• array_merge()‎: دمج مصفوفة أو أكثر.
• array_walk()‎: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة.
• array_values()‎: إعادة جميع القيم من المصفوفة.

مصادر

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