php array_unshiftを使用して、要素をアレイヘッダーに挿入するための完全なガイド

M66 2025-06-10

PHPの配列の先頭に要素を挿入する方法は？

PHPは、動的なWebサイトとアプリケーションの開発に広く使用されている強力なサーバー側のスクリプト言語です。配列データを処理する場合、アレイの開始位置に新しい要素を追加する必要があることがよくあります。この時点で、 array_unshift（）関数は非常に実用的なツールです。

array_unshift関数の基本的な使用

array_unshift（）の目的は、1つ以上の要素を配列の前面に挿入し、新しい配列の長さを返すことです。構文は次のとおりです。

 array_unshift(array $array, mixed $value1 [, mixed $value2, ...])

$配列：ターゲット配列
$ value1、$ value2 ... ：挿入する値は1つ以上にすることができます

例：配列の先頭に要素を挿入します

次の例は、array_unshift（）を使用して配列の前面に要素を追加する方法を示しています。

 
<?php
$fruits = array("apple", "orange", "banana");
echo "Before array_unshift:\n";
print_r($fruits);

array_unshift($fruits, "grape");
echo "After array_unshift:\n";
print_r($fruits);
?>

出力の結果は次のとおりです。

 
Before array_unshift:
Array
(
    [0] => apple
    [1] => orange
    [2] => banana
)
After array_unshift:
Array
(
    [0] => grape
    [1] => apple
    [2] => orange
    [3] => banana
)

上記のコードから、「ブドウ」がアレイの最初の位置に正常に挿入されたことがわかります。

例：アレイの先頭に複数の要素を挿入します

array_unshift（）は、複数の要素の挿入も一度にサポートしています。これが例です：

 
<?php
$numbers = array(3, 4, 5);
echo "Before array_unshift:\n";
print_r($numbers);

array_unshift($numbers, 1, 2);
echo "After array_unshift:\n";
print_r($numbers);
?>

出力の結果は次のとおりです。

 
Before array_unshift:
Array
(
    [0] => 3
    [1] => 4
    [2] => 5
)
After array_unshift:
Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

この方法により、配列の開始位置に任意の数の値を柔軟に追加できます。

要約します

array_unshift（）は、PHPの簡潔で強力な配列関数であり、配列の先頭に要素をすばやく挿入できます。単一の値であろうと複数の値の挿入であろうと、手動でアレイを再構築するという退屈な手順を避けて、簡単に実装できます。実際の開発では、このような機能の使用をマスターすることで、コードの効率と保守性が大幅に向上します。

array_unshift