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

Copy
1<?php
2
3/**
4 * array_pop関数の基本的な使用例を示します。
5 * array_popは配列の末尾から要素を取り出し、配列を短縮する関数です。
6 * キーワード「pop by index」に関連して、この関数は特定のインデックスを指定するのではなく、常に配列の最後の要素を操作します。
7 */
8
9// 1. サンプル配列を定義します。
10$fruits = ['apple', 'banana', 'cherry', 'date'];
11
12echo "--- array_popの基本的な使用例 ---\n";
13echo "元の配列:\n";
14print_r($fruits);
15
16// array_pop関数を実行し、配列の最後の要素を取り出します。
17// 配列は参照渡しで変更されます。
18$lastFruit = array_pop($fruits);
19
20echo "\n取り出された要素: " . $lastFruit . "\n";
21echo "array_pop後の配列:\n";
22print_r($fruits);
23
24// 2. 配列が空の場合のarray_popの挙動
25echo "\n--- 空の配列でのarray_popの挙動 ---\n";
26$emptyArray = [];
27echo "元の空の配列:\n";
28print_r($emptyArray);
29
30$resultFromEmpty = array_pop($emptyArray);
31
32echo "\n空の配列から取り出された要素:\n";
33var_dump($resultFromEmpty); // 空の配列からはnullが返されます。
34echo "array_pop後の空の配列:\n";
35print_r($emptyArray);
36
37?>

PHPのarray_pop関数は、配列の末尾から要素を一つ取り出し、その要素を返す機能を持つ関数です。この関数は、引数で渡された配列自体を変更し、末尾の要素が削除された新しい状態にします。

array_pop関数の引数array &$arrayは、変更したい配列を参照渡しで受け取ります。これにより、関数内で配列が直接操作され、元の配列から末尾の要素が取り除かれます。キーワードとして提示された「pop by index」に関連して、array_popは特定のインデックスを指定するのではなく、常に配列の「最後の要素」を操作するという点にご注意ください。

戻り値はmixed型で、取り出された要素の値が返されます。例えば、['apple', 'banana', 'cherry', 'date']という配列にarray_popを適用すると、'date'が戻り値として返され、元の配列は['apple', 'banana', 'cherry']となります。もし、array_popを呼び出した時点で配列が空の場合、取り出す要素がないため、戻り値としてnullが返されます。サンプルコードでは、$fruits配列から'date'が取り出され、元の配列が短縮される様子、また空の配列から呼び出した際にnullが返される様子が示されています。

Copy
1<?php
2
3/**
4 * 配列の末尾から指定された数の要素を取り出す関数です。
5 * array_pop関数を複数回実行することで、配列から複数の要素を削除し、
6 * それらを新しい配列として返します。
7 *
8 * @param array $array 処理対象の配列（参照渡しにより、元の配列が変更されます）。
9 * @param int $numToPop 取り出す要素の数。
10 * @return array 取り出された要素の配列。要素は元の配列の末尾に近いものから順に並びます。
11 */
12function arrayPopMultiple(array &$array, int $numToPop): array
13{
14    $poppedElements = []; // 取り出された要素を格納する新しい配列
15
16    // 取り出す要素の数が元の配列の総数を超えないように調整します。
17    // 例: 要素が3つの配列から5つ取り出そうとしても、実際には3つしか取り出せません。
18    $actualNumToPop = min($numToPop, count($array));
19
20    // 指定された回数だけ array_pop を繰り返します。
21    for ($i = 0; $i < $actualNumToPop; $i++) {
22        // array_popは配列の末尾から1つの要素を取り出し、元の配列からその要素を削除します。
23        $element = array_pop($array);
24
25        // 取り出された要素を $poppedElements の先頭に追加します。
26        // 例: ['a', 'b', 'c', 'd', 'e'] から3つ取り出す場合、
27        // 'e', 'd', 'c' の順に取り出されますが、array_unshift を使うことで、
28        // 結果の配列は ['c', 'd', 'e'] となります（末尾に近いものから順）。
29        array_unshift($poppedElements, $element);
30    }
31
32    return $poppedElements;
33}
34
35// --- 使用例 ---
36
37// 基本的な使用例
38$myArray = ['apple', 'banana', 'cherry', 'date', 'elderberry'];
39echo "元の配列: [" . implode(', ', $myArray) . "]\n";
40
41// 配列の末尾から3つの要素を取り出す
42$removedElements = arrayPopMultiple($myArray, 3);
43echo "取り出された要素: [" . implode(', ', $removedElements) . "]\n"; // 出力: [cherry, date, elderberry]
44echo "残りの配列: [" . implode(', ', $myArray) . "]\n\n"; // 出力: [apple, banana]
45
46// 配列の要素数より多く取り出そうとする場合の例
47$numbers = [10, 20, 30];
48echo "元の配列: [" . implode(', ', $numbers) . "]\n";
49$removedNumbers = arrayPopMultiple($numbers, 5); // 5つ指定しても、存在する3つだけが取り出される
50echo "取り出された要素: [" . implode(', ', $removedNumbers) . "]\n"; // 出力: [10, 20, 30]
51echo "残りの配列: [" . implode(', ', $numbers) . "]\n\n"; // 出力: []
52
53// 空の配列から取り出そうとする場合の例
54$emptyArray = [];
55echo "元の配列: [" . implode(', ', $emptyArray) . "]\n";
56$removedEmpty = arrayPopMultiple($emptyArray, 2);
57echo "取り出された要素: [" . implode(', ', $removedEmpty) . "]\n"; // 出力: []
58echo "残りの配列: [" . implode(', ', $emptyArray) . "]\n";
59

PHPのarray_pop関数は、配列の末尾から要素を1つ取り出し、元の配列からその要素を削除する機能を提供します。この関数は、スタック（後入れ先出し）のようなデータ構造を扱う際に非常に便利です。

提供されたサンプルコードでは、このarray_pop関数を複数回利用して、配列の末尾から指定された数の要素をまとめて取り出すarrayPopMultipleというカスタム関数が定義されています。この関数は、第一引数に渡された配列を参照渡しで受け取るため、元の配列自身が変更されます。具体的には、末尾から要素が指定された数だけ削除されます。

arrayPopMultipleの第二引数で取り出す要素の数を指定します。もし指定された数が配列の総要素数を超える場合でも、関数は存在する要素の数だけを安全に取り出します。戻り値としては、取り出された要素が新しい配列として返されます。このとき、要素は元の配列の末尾に近いものから順に格納されており、例えば['a', 'b', 'c', 'd', 'e']から3つ取り出すと、['c', 'd', 'e']という結果が得られます。

使用例では、['apple', 'banana', 'cherry', 'date', 'elderberry']から3つの要素を取り出すと、元の配列は['apple', 'banana']となり、取り出された要素は['cherry', 'date', 'elderberry']となります。このように、複数の要素を一度に効率よく削除し、取得することが可能です。