reset

(PHP 4, PHP 5, PHP 7, PHP 8)

reset — 將數(shù)組的內(nèi)部指針指向第一個單元

說明

reset(array|object &$array): mixed

reset() 將 array 的內(nèi)部指針倒回到第一個單元并返回第一個數(shù)組單元的值。

參數(shù)

array: 輸入的數(shù)組。

返回值

返回數(shù)組第一個單元的值，如果數(shù)組為空則返回 false。

警告

此函數(shù)可能返回布爾值 false，但也可能返回等同于 false 的非布爾值。請閱讀布爾類型章節(jié)以獲取更多信息。應使用 === 運算符來測試此函數(shù)的返回值。

更新日志

版本	說明
8.1.0	棄用在 object 上調(diào)用此函數(shù)。在 object 優(yōu)先使用 get_mangled_object_vars() 或者使用 ArrayIterator。

范例

示例 #1 reset() 例子


<?php

$array = array('step one', 'step two', 'step three', 'step four');

// 默認情況下，指針指向第一個元素
echo current($array) . "<br />\n"; // "step one"

// 跳過兩步
next($array);
next($array);
echo current($array) . "<br />\n"; // "step three"

// 重置指針，重新指向第一個元素
reset($array);
echo current($array) . "<br />\n"; // "step one"

?>

注釋

注意: 返回的值無法區(qū)分是空數(shù)組，還是第一個元素是 bool false。要正確檢測數(shù)組第一個元素包含 false 的情況，首先要檢測數(shù)組 count()，或在調(diào)用 reset() 后檢測 key() 不為 null。

參見

current() - 返回數(shù)組中的當前值
each() - 返回數(shù)組中當前的鍵／值對并將數(shù)組指針向前移動一步
end() - 將數(shù)組的內(nèi)部指針指向最后一個單元
next() - 將數(shù)組中的內(nèi)部指針向前移動一位
prev() - 將數(shù)組的內(nèi)部指針倒回一位
array_key_first() - 獲取指定數(shù)組的第一個鍵