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

Copy
1<?php
2
3/**
4 * reset() 関数を使った配列のサンプルコード
5 */
6
7// 配列を定義
8$array = ['apple', 'banana', 'orange'];
9
10// 配列の内部ポインタを先頭に移動
11$firstElement = reset($array);
12
13// 結果を出力
14echo "最初の要素: " . $firstElement . PHP_EOL; // 出力: 最初の要素: apple
15
16// もう一度確認
17echo "現在の要素 (current): " . current($array) . PHP_EOL; // 出力: 現在の要素 (current): apple
18
19// 配列が空の場合
20$emptyArray = [];
21$result = reset($emptyArray);
22
23// 空の配列の場合、reset() は false を返す
24var_dump($result); // 出力: bool(false)
25
26// オブジェクトのプロパティに対する reset() の挙動（非推奨、PHP 7.2 以降はエラー/警告）
27// ここでは説明のためにコメントアウトしていますが、オブジェクトでの使用は避けるべきです。
28/*
29$obj = new stdClass();
30$obj->a = 'A';
31$obj->b = 'B';
32reset($obj); // E_WARNING: reset() expects parameter 1 to be array, object given
33*/

PHPのreset()関数は、配列の内部ポインタを先頭の要素に移動させるために使用します。引数には、操作対象の配列を渡します。配列は参照渡しであるため、元の配列が直接変更されます。

サンプルコードでは、まず$arrayという名前の配列を定義し、reset()関数を適用しています。reset($array)を実行すると、配列の内部ポインタが最初の要素である'apple'を指すようになります。reset()関数は、配列の最初の要素の値を返します。もし配列が空の場合、reset()関数はfalseを返します。

current()関数を使って現在の要素を確認すると、reset()関数の実行後、最初の要素である'apple'が返されることがわかります。空の配列に対してreset()を適用した場合の挙動もvar_dump()で確認しています。

また、サンプルコードにはオブジェクトに対するreset()の適用例が含まれていますが、PHP 7.2以降では非推奨であり、E_WARNINGが発生します。したがって、reset()関数は配列に対してのみ使用するようにしてください。reset()関数を使うことで、配列の処理を最初からやり直したい場合に便利です。

Copy
1<?php
2
3/**
4 * 配列の内部ポインタを先頭に戻す reset() 関数の使用例
5 *
6 * reset() は配列の内部ポインタを最初の要素に移動し、その値を返します。
7 * この関数は配列のキーを振り直す（0から始まる連番にする）機能はありません。
8 */
9function demonstrateResetFunction(): void
10{
11    // キーが0から始まらない、かつ連続していない配列を定義
12    $fruits = [
13        1 => 'Apple',
14        3 => 'Banana',
15        5 => 'Cherry'
16    ];
17
18    echo '元の配列:' . PHP_EOL;
19    print_r($fruits);
20    echo PHP_EOL;
21
22    // next() を使って内部ポインタを2番目の要素 'Banana' に進める
23    next($fruits);
24    echo 'next() 実行後の現在の要素: ' . current($fruits) . PHP_EOL; // 出力: Banana
25    echo PHP_EOL;
26
27    // reset() を使って内部ポインタを先頭に戻す
28    // 戻り値として最初の要素の値 'Apple' が返される
29    $firstElement = reset($fruits);
30
31    echo 'reset() の戻り値: ' . $firstElement . PHP_EOL; // 出力: Apple
32    echo 'reset() 実行後の現在の要素: ' . current($fruits) . PHP_EOL; // 出力: Apple
33    echo PHP_EOL;
34
35    // reset() 実行後も、配列のキーは変更されていないことを確認
36    echo 'reset() 後の配列:' . PHP_EOL;
37    print_r($fruits);
38}
39
40// 関数を実行
41demonstrateResetFunction();
42

PHPのreset()関数は、配列の内部ポインタを先頭の要素に戻すための関数です。引数には、操作したい配列またはオブジェクトを渡します。この関数は参照渡しで動作するため、元の配列の内部ポインタが直接変更されます。戻り値としては、内部ポインタが移動した後の最初の要素の値が返されます。

サンプルコードでは、キーが0から始まらず、連続していない$fruits配列を例にreset()の挙動を確認しています。まずnext()関数で内部ポインタを2番目の要素「Banana」に進め、current()でその値を確認します。その後reset()を実行すると、内部ポインタは再び最初の要素である「Apple」に戻り、reset()の戻り値としても「Apple」が取得されます。current()で再度確認しても「Apple」が返されることがわかります。

重要な点として、reset()関数は配列の内部ポインタを操作するだけで、配列のキー自体を振り直したり、0から始まる連番にしたりする機能はありません。reset()実行後も、配列の構造（キーと値のペア）は元のまま維持されていることを、サンプルコードの出力から確認できます。