PHP array_push(): Cara Menambah Elemen ke Array

array_push($arr, $value) menambahkan sebuah nilai ke akhir array. Untuk satu nilai, singkatan $arr[] = $value; melakukan hal yang sama tanpa memanggil fungsi, dan cara inilah yang dipakai sebagian besar kode PHP. Keduanya mengubah array secara langsung.

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

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

print_r($colors);

array_push() menerima array lewat referensi, jadi fungsi ini mengubah variabel yang kamu berikan. Nilai kembaliannya adalah jumlah elemen yang baru, dan boleh kamu abaikan.

array_push vs $arr[] =

Pakai $arr[] = $value untuk satu nilai: lebih pendek dan tidak memanggil fungsi, yang terasa bedanya di dalam loop besar. Pakai array_push() saat kamu punya beberapa nilai untuk ditambahkan dalam satu pernyataan, atau sebuah daftar nilai yang ingin di-spread.

<?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[] = juga bekerja pada variabel yang belum ada: PHP akan membuat array-nya. array_push() butuh array yang sudah ada: pada variabel yang belum didefinisikan, fungsi ini melempar TypeError: array_push(): Argument #1 ($array) must be of type array, null given.

Menambah key dan nilai

array_push() hanya menambahkan nilai dengan key integer berikutnya. Untuk menambah key bernama, isi langsung ke key itu. Untuk menambah beberapa pasangan sekaligus, pakai += (mempertahankan key yang sudah ada) atau array_merge() (nilai baru yang menang).

<?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);

Perbedaan antara + dan array_merge() saat key-nya bentrok dibahas di halaman array_merge.

Menambah di awal: array_unshift

array_unshift($arr, $value) menyisipkan nilai di awal. Key integer dinomori ulang sehingga nilai baru mendapat indeks 0; key string tetap seperti semula. Sama seperti array_push(), fungsi ini menerima beberapa nilai dan mengembalikan jumlah elemen yang baru.

<?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);

Untuk menaruh pasangan bernama di urutan pertama, buat array baru: $menu = ['login' => '/login'] + $menu;.

Menyisipkan di posisi tertentu

array_splice($arr, $offset, 0, $values) menyisipkan tanpa menghapus apa pun: fungsi ini mulai di $offset, menghapus 0 elemen, lalu menaruh nilai baru di sana. Key integer setelah titik sisip dinomori ulang.

<?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() juga bisa menghapus dan mengganti elemen; halaman tentang menghapus elemen menunjukkan bentuk-bentuk itu.

Menambahkan array lain

array_push($a, $b) menambahkan $b sebagai satu elemen bersarang, yang jarang sesuai keinginanmu. Untuk menambahkan nilai-nilai $b satu per satu, spread nilainya, atau buat array baru dengan sintaks spread atau 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";

Kesalahan umum: menyimpan nilai kembalian

array_push() mengembalikan angka, yaitu jumlah elemen yang baru. Menyimpan angka itu kembali ke variabel array mengganti array-mu dengan integer, dan array_push() berikutnya pada variabel itu akan melempar 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);

Hal yang sama berlaku untuk array_unshift() dan untuk sort(), yang mengembalikan true. Fungsi yang mengubah array secara langsung mengembalikan status, bukan array-nya.