array_push() ב-PHP: הוספת איברים למערך

array_push($arr, $value) מוסיפה ערך לסוף מערך. לערך יחיד, הקיצור $arr[] = $value; עושה את אותה עבודה בלי קריאה לפונקציה, ובו משתמש רוב קוד ה-PHP. שתי הדרכים משנות את המערך במקום.

<?php
$colors = ['red', 'green'];

$colors[] = 'blue';                    // shorthand, one value
array_push($colors, 'yellow', 'pink'); // several values at once

print_r($colors);

array_push() מקבלת את המערך לפי הפניה, ולכן היא משנה את המשתנה שמעבירים לה. היא מחזירה את מספר האיברים החדש, ואפשר להתעלם ממנו.

array_push מול $arr[] =

השתמשו ב-$arr[] = $value לערך אחד: זה קצר יותר וחוסך קריאה לפונקציה, וזה מצטבר בתוך לולאה גדולה. השתמשו ב-array_push() כשיש לכם כמה ערכים להוסיף בפקודה אחת, או רשימת ערכים לפרוס פנימה.

<?php
$log = [];
for ($i = 1; $i <= 3; $i++) {
    $log[] = "step $i";
}

$more = ['step 4', 'step 5'];
$count = array_push($log, ...$more);   // spread a list in

print_r($log);
echo "Now $count entries\n";

$arr[] = עובד גם על משתנה שעוד לא קיים: PHP יוצרת את המערך. array_push() צריכה מערך קיים: על משתנה לא מוגדר היא זורקת TypeError: array_push(): Argument #1 ($array) must be of type array, null given.

הוספת מפתח וערך

array_push() מוסיפה ערכים רק עם המפתח השלם הבא. כדי להוסיף מפתח עם שם, הציבו אליו. כדי להוסיף כמה זוגות בבת אחת, השתמשו ב-+= (שומר על מפתחות קיימים) או ב-array_merge() (נותן לערכים החדשים לנצח).

<?php
$user = ['name' => 'Ada'];

$user['email'] = 'ada@example.com';             // one key and value
$user += ['role' => 'admin', 'name' => 'X'];    // adds role; name already exists, kept

print_r($user);

array_push($user, 'oops');                      // gets key 0, not a name
print_r($user);

ההבדל בין + ל-array_merge() כשמפתחות מתנגשים מוסבר בעמוד array_merge.

הוספה להתחלה: array_unshift

array_unshift($arr, $value) מכניסה בהתחלה. המפתחות השלמים ממוספרים מחדש כך שהערך החדש מקבל את האינדקס 0; מפתחות מחרוזת נשארים כמו שהם. כמו array_push(), היא מקבלת כמה ערכים ומחזירה את המספר החדש.

<?php
$queue = ['Linus', 'Grace'];
array_unshift($queue, 'Ada');
print_r($queue);

$menu = ['home' => '/', 'about' => '/about'];
array_unshift($menu, '/login');      // string keys are kept, the new value gets key 0
print_r($menu);

כדי לשים זוג עם שם ראשון, בנו מערך חדש: $menu = ['login' => '/login'] + $menu;.

הכנסה במיקום מסוים

array_splice($arr, $offset, 0, $values) מכניסה בלי להסיר שום דבר: היא מתחילה ב-$offset, מסירה 0 איברים ושמה שם את הערכים החדשים. המפתחות השלמים שאחרי נקודת ההכנסה ממוספרים מחדש.

<?php
$letters = ['a', 'b', 'd', 'e'];

array_splice($letters, 2, 0, 'c');           // insert 'c' at index 2
print_r($letters);

array_splice($letters, 1, 0, ['x', 'y']);    // insert two values at index 1
echo implode(' ', $letters), "\n";

array_splice() יכולה גם להסיר ולהחליף איברים; העמוד על הסרת איברים מראה את הצורות האלה.

הוספת מערך אחר

array_push($a, $b) מוסיפה את $b כאיבר מקונן אחד, ולעיתים רחוקות זה מה שרוצים. כדי להוסיף את הערכים של $b אחד אחד, פרסו אותם, או בנו מערך חדש עם תחביר הפריסה או עם array_merge().

<?php
$a = [1, 2];
$b = [3, 4];

$nested = $a;
array_push($nested, $b);       // [1, 2, [3, 4]]
echo json_encode($nested), "\n";

$flat = $a;
array_push($flat, ...$b);      // [1, 2, 3, 4]
echo json_encode($flat), "\n";

echo json_encode([...$a, ...$b]), "\n";

טעות נפוצה: הצבת ערך ההחזרה

array_push() מחזירה מספר, את מספר האיברים החדש. הצבה שלו בחזרה למשתנה המערך מחליפה את המערך שלכם במספר שלם, וה-array_push() הבא עליו זורק TypeError.

<?php
$items = ['pen', 'book'];

$result = array_push($items, 'lamp');
var_dump($result);    // the count, not the array

// Wrong: $items = array_push($items, 'mug');  turns $items into int(4)
array_push($items, 'mug');   // right: call it on its own line
print_r($items);

אותו הדבר נכון ל-array_unshift() ול-sort(), שמחזירה true. פונקציות שמשנות מערך במקום מחזירות סטטוס, לא את המערך.