reset

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

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

說(shuō)明

reset(array|object &$array): mixed

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

參數(shù)

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

返回值

返回?cái)?shù)組第一個(gè)單元的值，如果數(shù)組為空則返回 false。

警告

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

更新日志

版本	說(shuō)明
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');

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

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

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

?>

注釋

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

參見(jiàn)

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