【PHP8.x】array_splice関数の使い方

Copy
1<?php
2
3/**
4 * array_splice 関数を使って連想配列を操作する例を示します。
5 *
6 * array_splice 関数は、配列の指定した位置から要素を削除し、
7 * 必要に応じて新しい要素を挿入するために使用されます。
8 * 連想配列の場合でも、オフセットと長さは数値インデックスとして扱われますが、
9 * 既存のキーは維持され、挿入される要素のキーも維持されます。
10 */
11function demonstrateArraySpliceWithAssociativeArray(): void
12{
13    // 操作対象となる連想配列を定義します。
14    $associativeArray = [
15        'apple'      => 100,
16        'banana'     => 150,
17        'cherry'     => 200,
18        'date'       => 250,
19        'elderberry' => 300,
20    ];
21
22    echo "--- 元の連想配列 ---\n";
23    print_r($associativeArray);
24
25    // 例1: 特定の要素を削除する
26    // オフセット1（2番目の要素 'banana'）から1つの要素を削除します。
27    // array_spliceは数値インデックスで処理するため、キーに関わらず位置で指定します。
28    echo "\n--- 1. オフセット1から1つの要素を削除 ---\n";
29    $removedElements1 = array_splice($associativeArray, 1, 1);
30    echo "削除された要素:\n";
31    print_r($removedElements1);
32    echo "操作後の配列:\n";
33    print_r($associativeArray);
34    // 結果: 'banana' => 150 が削除され、残りの要素が詰まります。
35    // キーは維持されます: ['apple' => 100, 'cherry' => 200, 'date' => 250, 'elderberry' => 300]
36
37    // 例2: 特定の要素を別の連想配列で置換する
38    // 現在の配列のオフセット2（3番目の要素 'date'）から1つの要素を削除し、
39    // 新しい連想配列 ['fig' => 350, 'grape' => 400] を挿入します。
40    echo "\n--- 2. オフセット2から1つの要素を別の連想配列で置換 ---\n";
41    $replacementArray = ['fig' => 350, 'grape' => 400];
42    $removedElements2 = array_splice($associativeArray, 2, 1, $replacementArray);
43    echo "削除された要素:\n";
44    print_r($removedElements2);
45    echo "操作後の配列:\n";
46    print_r($associativeArray);
47    // 結果: 'date' => 250 が削除され、その位置に 'fig' と 'grape' が挿入されます。
48    // ['apple' => 100, 'cherry' => 200, 'fig' => 350, 'grape' => 400, 'elderberry' => 300]
49
50    // 例3: 特定の位置に連想配列を挿入する (削除する要素は0)
51    // 現在の配列のオフセット1（2番目の要素 'cherry' の前）に、
52    // 新しい連想配列 ['honeydew' => 450] を挿入します。
53    // 削除する要素数は 0 なので、既存の要素は削除されずに後ろにずれます。
54    echo "\n--- 3. オフセット1に新しい連想配列を挿入 ---\n";
55    $insertionArray = ['honeydew' => 450];
56    $removedElements3 = array_splice($associativeArray, 1, 0, $insertionArray);
57    echo "削除された要素 (挿入のみの場合は空の配列):\n";
58    print_r($removedElements3); // この場合は空の配列が返されます
59    echo "操作後の配列:\n";
60    print_r($associativeArray);
61    // 結果: 'apple' と 'cherry' の間に 'honeydew' が挿入されます。
62    // ['apple' => 100, 'honeydew' => 450, 'cherry' => 200, 'fig' => 350, 'grape' => 400, 'elderberry' => 300]
63}
64
65// 関数を実行して、連想配列に対する array_splice の動作を確認します。
66demonstrateArraySpliceWithAssociativeArray();
67
68?>

array_splice関数は、配列の指定した位置から要素を削除し、必要に応じて新しい要素を挿入するために使用されます。第一引数$arrayには操作対象の配列を、第二引数$offsetには操作を開始する位置を整数で指定します。第三引数$lengthで削除する要素数を指定でき、省略すると$offset以降の全ての要素が削除されます。$lengthに0を指定すると、要素を削除せずに挿入のみが行われます。第四引数$replacementには挿入したい要素を配列として指定できます。この関数は、削除された要素を新しい配列として返します。

連想配列に対してarray_spliceを使用する場合、$offsetと$lengthはキーではなく、配列の先頭から0, 1, 2...と数えられる数値インデックスとして扱われます。例えば、サンプルコードの例1では、元の連想配列のオフセット1、つまり2番目の要素である'banana'が削除されました。削除された要素も連想配列として返されます。例2では、特定の要素を別の連想配列で置換しており、削除された要素が返され、指定位置に新しいキーと値が維持されたまま挿入されています。例3では、$lengthを0とすることで、既存の要素を削除せずに、指定された$offsetに新しい連想配列を挿入する様子が示されています。このように、array_spliceは連想配列のキーを維持しながら、要素の削除、置換、挿入を柔軟に行うことができます。

Copy
1<?php
2
3/**
4 * array_splice を使って連想配列の要素を操作するサンプルです。
5 *
6 * array_splice は、連想配列に対しても数値インデックスに基づいて要素の削除、置換、挿入を行います。
7 * オフセットと長さは要素の順序に基づきますが、置き換え要素として渡す連想配列のキーは保持されます。
8 */
9
10// 元の連想配列
11$userData = [
12    'id' => 101,
13    'name' => 'Alice Smith',
14    'email' => 'alice@example.com',
15    'age' => 30,
16    'status' => 'active',
17];
18
19echo "--- 元の連想配列 ---\n";
20print_r($userData);
21
22// 1. 'email' と 'age' を削除する (インデックス 2 と 3 の要素)
23// array_spliceは元の配列を変更し、削除された要素の配列を返します。
24$removedElements = array_splice($userData, 2, 2);
25
26echo "\n--- 'email' と 'age' を削除後 ---\n";
27print_r($userData);
28echo "削除された要素:\n";
29print_r($removedElements); // 出力: ['email' => 'alice@example.com', 'age' => 30]
30
31// 現在の $userData の状態:
32// ['id' => 101, 'name' => 'Alice Smith', 'status' => 'active']
33// (内部的な数値インデックス: 0 => 'id', 1 => 'name', 2 => 'status')
34
35// 2. 'name' (インデックス1) の後に新しい要素 'firstName' と 'lastName' を挿入する
36// オフセット1の位置で0個の要素を削除し、指定の連想配列を挿入します。
37array_splice($userData, 1, 0, [
38    'firstName' => 'Bob',
39    'lastName' => 'Johnson',
40]);
41
42echo "\n--- 'firstName' と 'lastName' 挿入後 ---\n";
43print_r($userData);
44
45// 現在の $userData の状態:
46// ['id' => 101, 'firstName' => 'Bob', 'lastName' => 'Johnson', 'name' => 'Alice Smith', 'status' => 'active']
47// (内部的な数値インデックス: 0 => 'id', 1 => 'firstName', 2 => 'lastName', 3 => 'name', 4 => 'status')
48
49// 3. 'status' (インデックス4) を新しい要素で置換する
50// オフセット4の位置で1個の要素を削除し、指定の連想配列を挿入します。
51array_splice($userData, 4, 1, [
52    'isAdmin' => true,
53    'lastLogin' => '2023-10-27 10:00:00',
54]);
55
56echo "\n--- 'status' を 'isAdmin' と 'lastLogin' で置換後 ---\n";
57print_r($userData);
58
59// 最終的な $userData の状態:
60// ['id' => 101, 'firstName' => 'Bob', 'lastName' => 'Johnson', 'name' => 'Alice Smith', 'isAdmin' => true, 'lastLogin' => '2023-10-27 10:00:00']

PHPのarray_splice関数は、配列から指定した要素を削除したり、新しい要素で置き換えたり、特定の場所に挿入したりするために使われます。この関数は、第一引数で渡された配列自体を変更する点が特徴で、削除された要素は戻り値として新しい配列で返されます。

array_spliceでは、操作の開始位置を示す$offsetと、削除する要素の数を示す$lengthを数値インデックスで指定します。連想配列の場合も、要素の物理的な並び順を0から始まる数値インデックスとして扱います。もし$lengthに0を指定した場合、要素の削除は行われず、$offsetで指定した位置に第三引数$replacementの要素を挿入できます。

サンプルコードでは、まず$userDataという連想配列から、数値インデックスで2番目と3番目の要素（'email'と'age'）を削除しています。次に、'name'の要素の後に'firstName'と'lastName'という新しい連想配列要素を挿入し、その後'status'要素を'isAdmin'と'lastLogin'で置き換えています。ここで挿入や置換に連想配列を渡した場合、$replacementで指定した連想配列のキーはそのまま保持されて元の配列に組み込まれます。これにより、連想配列のキー構造を維持しつつ、柔軟な配列操作が可能です。