PHP/array combine

الدالة 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_combine في توثيق PHP الرسمي.