array_merge_recursive()‎

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

تدمج الدالة array_merge_recursive()‎ مصفوفتين أو أكثر بشكل تكراري (recursively).

الوصف

array array_merge_recursive ( array $array1 [, array $... ] )

تدمج الدالة عناصر مصفوفة أو أكثر بحيث تضيف عناصر المصفوفة إلى عناصر المصفوفة السابقة لها. تعيد الدالةُ المصفوفةَ الناتجة والمحتوية على عناصر كل المصفوفات.

إذا احتوت المصفوفة على مفاتيح متماثلة في التمثيل النصي، فستضيف الدالة العناصر المرتبطة بهذه المفاتيح بشكل تكراري، بحيث أنه إذا كانت قيمة العنصر هي مصفوفة في حد ذاتها، فستدمج مع المصفوفة الأخرى. إذا احتوت المصفوفة على نفس المفتاح العددي فإن قيمة العنصر المرتبط به لن تمحو قيمة العنصر الأول وإنما ستُضاف معه.

المعاملات

array1

المصفوفة المبدئية التي ستدمجها الدالة.

…

قائمة متغيرة من المصفوفات التي ستدمجها الدالة.

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

تعيد مصفوفة من القيم الناتجة عن دمج المصفوفات المُمَرَّرة إليها.

أمثلة

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

<?php
$ar1 = array("color" => array("favorite" => "red"), 5);
$ar2 = array(10, "color" => array("favorite" => "green", "blue"));
$result = array_merge_recursive($ar1, $ar2);
print_r($result);
?>

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

Array
(
    [color] => Array
        (
            [favorite] => Array
                (
                    [0] => red
                    [1] => green
                )

            [0] => blue
        )

    [0] => 5
    [1] => 10
)

انظر أيضًا

• الدالة array_merge()‎: تدمج مصفوفة واحدة أو أكثر.
• الدالة array_replace_recursive()‎: تستبدل عناصر من المصفوفات المُمرَّرة إلى المصفوفة الأولى بشكل تكراري (recursively).

مصادر

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