جایگزینی (array_replace)
با «جایگزینی آرایه» مقدارهای آرایه اول را عوض می کنیم. تابع «array_replace» این کار را انجام می دهد. جایگزینی یعنی مقدارهای هم کلید، با مقدارهای جدید عوض شوند. مثل تعویض برچسب های تکراری در آلبوم.
تعریف و کاربرد جایگزینی آرایه
array_replace مقدارهای آرایه اول را با آرایه های بعدی عوض می کند. اگر کلید در آرایه دوم باشد، مقدارش جایگزین می شود. اگر کلید فقط در اول باشد، همان می ماند. اگر کلید در دوم باشد و در اول نباشد، ساخته می شود. با چند آرایه، مقدارهای آخرین آرایه می چربد.
سینتکس (Syntax)
array_replace($array1, $array2, $array3);
نکته: می توانی یک یا چند آرایه بدهی. آرایه های بعدی قبلی ها را می پوشانند.
مثال 1: جایگزینی ساده با دو آرایه
مقدارهای آرایه اول با مقدارهای هم جایگاه در دومی عوض می شوند.
<?php
$a1 = array("red", "green");
$a2 = array("blue", "yellow");
print_r(array_replace($a1, $a2));
?>
مثال 2: کلید مشترک و کلید فقط در اول
اگر کلید در هر دو باشد، مقدار عوض می شود. اگر فقط در اول باشد، می ماند.
<?php
$a1 = array("a" => "red", "b" => "green");
$a2 = array("a" => "orange", "burgundy");
print_r(array_replace($a1, $a2));
?>
مثال 3: ساخت کلید جدید در آرایه اول
اگر کلید در دوم باشد و در اول نباشد، در اول ساخته می شود.
<?php
$a1 = array("a" => "red", "green");
$a2 = array("a" => "orange", "b" => "burgundy");
print_r(array_replace($a1, $a2));
?>
مثال 4: سه آرایه؛ آخرین آرایه برنده است
وقتی چند آرایه بدهی، مقدارهای آرایه آخر قبلی ها را می پوشانند.
<?php
$a1 = array("red", "green");
$a2 = array("blue", "yellow");
$a3 = array("orange", "burgundy");
print_r(array_replace($a1, $a2, $a3));
?>
مثال 5: کلیدهای عددی مشخص
می توانی با کلیدهای عددی خاص، فقط همان جایگاه ها را عوض کنی.
<?php
$a1 = array("red", "green", "blue", "yellow");
$a2 = array(0 => "orange", 3 => "burgundy");
print_r(array_replace($a1, $a2));
?>
جزئیات فنی کوتاه
خروجی، آرایه جایگزین شده است. در خطا، NULL برمی گردد. از PHP 5.3.0 پشتیبانی می شود.
لینک های داخلی مفید
برای «جایگزینی آرایه» به این صفحه رجوع کن. برای نسخه بازگشتی، array_replace_recursive را ببین. همچنین صفحه آرایه ها در PHP مفید است.
جمع بندی سریع
- کلید مشترک، مقدارش جایگزین می شود.
- کلید جدید، در آرایه اول ساخته می شود.
- چند آرایه دادی؟ آخرین آرایه برنده است.
- خروجی، آرایه نهاییِ جایگزین شده است.