عرض مصدر PHP/array replace recursive

<noinclude>{{DISPLAYTITLE:<code>array_replace_recursive()‎</code>}}</noinclude>
(PHP 5 >= 5.3.0, PHP 7)

تستبدل الدالة <code>array_replace_recursive()</code>‎ عناصر المصفوفات المُمررة إلى المصفوفة الأولى بشكل متكرر.

== الوصف ==
<syntaxhighlight lang="php">
array array_replace_recursive ( array $array1 , array $array2 [, array $... ])
</syntaxhighlight>تستبدل الدالة <code>array_replace_recursive()</code>‎ قيم <code>array1</code> بنفس القيم من كل المصفوفات التالية. في حالة وجود مفتاح من المصفوفة الأولى في المصفوفة الثانية، فستُستبدل قيمته بقيمة المفتاح المقابل من المصفوفة الثانية. إذا كان المفتاح موجودًا في المصفوفة الثانية، وغير موجود في الأولى، فسيُنشأ في المصفوفة الأولى. إذا كان هناك مفتاح موجود فقط في المصفوفة الأولى، فسيُترك كما هو. إذا مررنا عدة مصفوفات لاستبدال، فستُعالج بالترتيب، وتكتب المصفوفة الأحدث فوق القيم السابقة.

الدالة <code>array_replace_recursive()‎</code> دالة تكرارية: فهي تكرر التعامل مع المصفوفات وتطبق نفس العملية على القيمة الداخلية.

عندما تكون القيمة في <code>array1</code> أوليّة (scalar) فستُستبدل بالقيمة في <code>array2</code> التي قد تكون أوليةً أو مصفوفةً. وعندما تكون كلًا من القيمة في <code>array1</code> و <code>array2</code> مصفوفات، فستستبدل <code>array_replace_recursive()</code>‎ قيمتهما تكراريًا (recursively).

== المعاملات ==

=== <code>array1</code> ===
المصفوفة التي يُستبدل العناصر فيها.

=== <code>array2</code> ===
المصفوفة التي يُستخرج منها العناصر.

=== <code>...</code> ===
اختياري. المزيد من المصفوفات التي يُستخرج منها العناصر.

== القيم المعادة ==
إرجاع مصفوفة، أو القيمة <code>NULL</code> في حالة حدوث خطأ.

== أمثلة ==
المثال 1: مثال على الدالة <code>array_replace_recursive()‎</code><syntaxhighlight lang="php">
<?php
$base = array('citrus' => array( "orange") , 'berries' => array("blackberry", "raspberry"), );
$replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry'));

$basket = array_replace_recursive($base, $replacements);
print_r($basket);

$basket = array_replace($base, $replacements);
print_r($basket);
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
            [1] => raspberry
        )

)
Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
        )

)
</syntaxhighlight>المثال 2: مثال على الدالة <code>array_replace_recursive()‎</code> والسلوك التكراري<syntaxhighlight lang="php">
<?php
$base = array('citrus' => array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' );
$replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis'));
$replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis');

$basket = array_replace_recursive($base, $replacements, $replacements2);
print_r($basket);

?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
Array
(
    [citrus] => Array
        (
            [0] => pineapple
        )

    [berries] => Array
        (
            [0] => blueberry
            [1] => raspberry
        )

    [others] => litchis
)
</syntaxhighlight>

== انظر أيضًا ==
* <code>[[PHP/array_replace|array_replace()‎]]</code>: استبدال عناصر المصفوفات المُمررة إلى المصفوفة الأولى.
* <code>[[PHP/array_merge_recursive|array_merge_recursive()‎]]</code>: دمج مصفوفتين أو أكثر بشكل تكراري (recursively).

== مصادر ==
* [http://php.net/manual/en/function.array-replace-recursive.php صفحة الدالة array_replace_recursive في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]