函數速查表
| 函數 | 作用 | 返回值 | 指針移動 |
current($arr) | 返回當前元素值 | 當前值 / false | 不移動 |
next($arr) | 指針前進一位,返回新當前值 | 下一個值 / false | +1 |
prev($arr) | 指針後退一位,返回新當前值 | 上一個值 / false | -1 |
end($arr) | 指針移至最後,返回最後值 | 最後值 / false | 移至末尾 |
reset($arr) | 指針重置到第一個,返回首值 | 第一個值 / false | 移至開頭 |
key($arr) | 返回當前鍵名 | 鍵名 / null | 不移動 |
each($arr) | 返回當前鍵值對並前進 | [key, value] / false | +1 |
代碼演示:指針移動軌跡
<?php
$transport = ['foot', 'bike', 'car', 'plane'];
// 初始指針指向第一個
echo current($transport); // 'foot'
echo next($transport); // 'bike' (指針→1)
echo current($transport); // 'bike' (指針仍在 1)
echo prev($transport); // 'foot' (指針→0)
echo end($transport); // 'plane' (指針→3)
echo current($transport); // 'plane'
reset($transport); // 重置指針→0
echo current($transport); // 'foot'
?>
進階用法:遍歷數組而不改變原指針
// 1. foreach (不影響內部指針,推薦)
foreach ($arr as $k => $v) { ... }
// 2. 手動控制指針 (需保存/恢復)
$oldKey = key($arr);
while (($val = current($arr)) !== false) {
// process
next($arr);
}
// 恢復指針位置 (PHP 7+ 可用 array_key_first/last)
while (key($arr) !== $oldKey) prev($arr);
常見陷阱
- 傳值 vs 傳址:
current($arr) 接收引用,但 foreach 在 PHP 7+ 也不再影響外部指針。
false 歧義:數組元素值為 false 時無法區分是否到達末尾 → 必須用 key($arr) === null 判斷。
- 引用傳遞修改:
next(&$arr) 會報錯,這些函數參數必須是變量而非表達式。
現代替代:迭代器模式
class ArrayIterator implements Iterator {
private $arr, $pos = 0;
public function __construct(array $arr) { $this->arr = $arr; }
public function current() { return $this->arr[$this->pos]; }
public function key() { return $this->pos; }
public function next() { $this->pos++; }
public function rewind() { $this->pos = 0; }
public function valid() { return isset($this->arr[$this->pos]); }
}
// 使用
$it = new ArrayIterator($transport);
foreach ($it as $k => $v) { ... } // 完全可控、可嵌套、可暫停