php array_unshift（）関数詳細説明：配列の先頭に要素を挿入する方法

M66 2025-06-12

php array_unshift（）関数詳細説明：配列の先頭に要素を挿入する方法

PHP開発では、アレイは非常に一般的なデータ構造です。 Arrayの先頭に新しい要素を挿入する必要がある場合、PHPでarray_unshift（）関数を使用できます。この記事では、array_unshift（）関数の使用法を紹介して、この関数をよりよく理解して適用するのに役立ちます。

array_unshift（）関数の紹介

array_unshift（）関数は、配列の先頭に1つ以上の要素を挿入するために使用され、配列の長さが変更されます。挿入後、元の要素は順番に後方に移動します。

array_unshift（）function syntax

array_unshift（array＆$ array、mixed $ value1 [、Mixed $ ...]）

パラメーター説明：

＆$ array ：必須。操作する配列は、参照を使用して通過します。
$ value1 ：必須。挿入する要素は1つ以上にすることができます。

サンプルコード

Array_unshift（）を使用してArrayの先頭に要素を挿入する方法を示す簡単な例を次に示します。

<?php
$fruit = array("apple", "banana", "orange");

echo "オリジナル配列：";
print_r($fruit);

array_unshift($fruit, "lemon");

echo "挿入後の新しい配列：";
print_r($fruit);
?>

上記の例では、最初に3つのフルーツ要素を備えた配列$フルーツを作成します。次に、array_unshift（）関数を使用して「レモン」を配列の先頭に挿入し、 print_r（）関数を介して配列の変更を印刷します。

出力結果：

コードを実行した後、出力の結果は次のとおりです。

オリジナル配列：
（

[0] => Apple
[1] =>バナナ
[2] =>オレンジ

））

挿入後の新しい配列：
（

[0] =>レモン
[1] => Apple
[2] =>バナナ
[3] =>オレンジ

））

上記の出力から、array_unshift（）が「レモン」がアレイの先頭に正常に挿入され、元の要素が順番に後方に移動することがわかります。

返品値

Array_unshift（）関数は、変更された配列自体ではなく、挿入された要素の後に新しい配列の長さを返すことに注意する必要があります。

複数の要素を挿入します

単一の要素を挿入することに加えて、array_unshift（）関数は、複数の要素の挿入も一度にサポートします。これが例です：

<?php
$numbers = array(4, 5);

echo "オリジナル配列：";
print_r($numbers);

array_unshift($numbers, 1, 2, 3);

echo "挿入後の新しい配列：";
print_r($numbers);
?>

上記のコードを実行した後、出力の結果は次のとおりです。

オリジナル配列：
（

[0] => 4
[1] => 5

））

挿入後の新しい配列：
（

[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5

））

この例から、array_unshift（）関数は、アレイの先頭に同時に複数の要素を挿入し、それに応じて配列の長さが変化することがわかります。

要約します

array_unshift（）関数は、PHPで一般的に使用される配列操作関数であるため、1つ以上の要素を配列の先頭に簡単に挿入できます。この関数を習得した後、開発中にアレイを柔軟に操作して、さまざまなニーズを満たすことができます。

print_r