【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 * array_pop関数の基本的な使用方法を示すサンプルコードです。
5 *
6 * array_popは、配列の末尾から要素を取り除き、その取り除いた要素の値を返します。
7 * 元の配列は参照渡しされるため、関数実行後に変更されます。
8 */
9function demonstrateArrayPopUsage(): void
10{
11    // PHPの配列を定義します。
12    $fruits = ['apple', 'banana', 'cherry', 'date'];
13
14    echo "--- array_popの使用例 ---" . PHP_EOL;
15    echo "1. 元の配列の状態:" . PHP_EOL;
16    print_r($fruits); // 配列の内容をデバッグ出力します。
17
18    // array_popを呼び出し、配列の末尾の要素を取り出します。
19    // この場合、「date」が配列から取り除かれ、$lastElementに代入されます。
20    $lastElement = array_pop($fruits);
21
22    echo "2. 取り出された要素: " . $lastElement . PHP_EOL;
23
24    echo "3. array_pop後の配列の状態:" . PHP_EOL;
25    print_r($fruits); // 「date」が取り除かれた配列が表示されます。
26}
27
28// 上記で定義した関数を実行します。
29demonstrateArrayPopUsage();
30
31?>

PHP 8で利用できるarray_pop関数は、配列の末尾にある要素を一つ取り除くための機能です。この関数は、引数として操作対象の配列をarray &$arrayのように参照渡しで受け取ります。そのため、array_pop関数が実行されると、元の配列自体が変更され、末尾の要素が削除されます。

戻り値はmixed型で、配列から取り除かれた要素の値が返されます。もし配列が空の場合、nullが返されます。

サンプルコードでは、まず['apple', 'banana', 'cherry', 'date']という$fruits配列を定義しています。array_popを実行する前には、この配列がそのまま表示されます。

次に$lastElement = array_pop($fruits);と呼び出すことで、配列の末尾にある'date'が$fruits配列から取り除かれ、$lastElement変数に'date'が代入されます。

この操作の後、$fruits配列の内容を確認すると、'date'が削除され['apple', 'banana', 'cherry']のように変更されていることがわかります。このように、array_popは配列から要素を取り出すだけでなく、元の配列を直接変更する点が特徴です。

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']となります。このように、複数の要素を一度に効率よく削除し、取得することが可能です。

Copy
1<?php
2
3/**
4 * PHPのarray_pop関数の基本的な使用方法を示します。
5 * 配列に要素を投入 (populate) し、その後array_popで末尾から要素を取り除く例です。
6 */
7function demonstrateArrayPop(): void
8{
9    // 配列にいくつかの要素を投入 (populate) します。
10    // システムエンジニアにとって、データ構造の初期化は基本的な作業です。
11    $fruits = ['apple', 'banana', 'orange', 'grape'];
12
13    echo "元の配列:\n";
14    print_r($fruits); // 配列の内容を見やすく表示
15
16    // array_pop関数は、配列の末尾から要素を取り除き、その要素の値を返します。
17    // 元の配列は変更され、取り除かれた要素は失われます。
18    $lastFruit = array_pop($fruits);
19
20    echo "\n取り除かれた要素: " . $lastFruit . "\n"; // 取り除かれた要素の表示
21    echo "array_pop後の配列:\n";
22    print_r($fruits); // 要素が一つ減った後の配列の表示
23
24    // 空の配列にarray_popを適用した場合の動作も確認します。
25    // 空の配列から要素を取り除こうとすると、nullが返されます。
26    $emptyArray = [];
27    $resultFromEmpty = array_pop($emptyArray);
28
29    echo "\n空の配列から取り除かれた要素: ";
30    var_dump($resultFromEmpty); // nullが返されたことを確認
31    echo "array_pop後の空の配列:\n";
32    print_r($emptyArray); // 空のまま
33}
34
35// 関数を実行して動作を確認します。
36demonstrateArrayPop();
37
38?>

PHPのarray_pop関数は、配列の末尾から要素を効率的に取り除くための関数です。この関数は、引数として受け取った配列から最後の要素を一つ削除し、その削除された要素の値を戻り値として返します。array_popの大きな特徴は、引数で渡された元の配列そのものが変更される点です。これにより、関数実行後には配列の要素数が一つ減少します。

例えば、['apple', 'banana', 'orange', 'grape']のように複数の要素が「投入（populate）」された配列に対しarray_popを適用すると、末尾の'grape'が取り除かれ、その値が戻り値として得られます。同時に、元の配列は['apple', 'banana', 'orange']へと変化します。

また、もし空の配列に対してarray_popを実行した場合、取り除く要素が存在しないため、戻り値はnullとなります。システムエンジニアにとって、動的に変化するデータ（例えばキューやスタックのようなデータ構造の末尾）を扱う際に、この関数は非常に役立ちます。