array_replace()
(PHP 5 >= 5.3.0, PHP 7)
تستبدل الدالة array_replace() عناصر المصفوفات المُمررة إلى داخل المصفوفة الأولى.
الوصف
array array_replace ( array $array1 , array $array2 [, array $... ] )
تستبدل الدالة array_replace() قيم المصفوفة array1 بقيم لها نفس المفاتيح في كل من المصفوفات التالية. في حالة وجود مفتاح من المصفوفة الأولى في المصفوفة الثانية، تُستبدل قيمته بقيمة المفتاح المقابل من المصفوفة الثانية. وإذا كان المفتاح موجود في المصفوفة الثانية، وغير موجود في الأولى، فسيُنشأ في المصفوفة الأولى. أما إذا كان هناك مفتاح موجود في المصفوفة الأولى فقط، فسيُترك كما هو. في حالة تمرير عدة مصفوفات للاستبدال، فستعالج بالترتيب، وتكتب المصفوفات اللاحقة فوق القيم السابقة.
الدالة array_replace() غير تكرارية (recursive): سوف تستبدل القيم في المصفوفة الأولى بأي نوع موجود في المصفوفة الثانية.
المعاملات
array1
المصفوفة التي يُستبدل العناصر فيها.
array2
المصفوفة التي يُستخرج منها العناصر.
...
المزيد من المصفوفات التي يُستخرج منها العناصر. وتُكتب القيم من المصفوفات اللاحقة فوق القيم السابقة.
القيم المُعادة
تعيد الدالة مصفوفة، أو القيمة NULL في حالة حدوث خطأ.
أمثلة
المثال 1: مثال على الدالة array_replace()
<?php
$base = array("orange", "banana", "apple", "raspberry");
$replacements = array(0 => "pineapple", 4 => "cherry");
$replacements2 = array(0 => "grape");
$basket = array_replace($base, $replacements, $replacements2);
print_r($basket);
?>
سوف تكون مُخرجات المثال أعلاه كالتالي:
Array
(
[0] => grape
[1] => banana
[2] => apple
[3] => raspberry
[4] => cherry
)
انظر أيضًا
array_replace_recursive(): استبدال عناصر المصفوفات المُمررة إلى المصفوفة الأولى تكراريًا (recursively).array_merge(): دمج مصفوفة أو أكثر.