PHP Manual
陣列函式
將陣列的內部指針指向第一個單元

reset

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

reset — 將陣列的內部指針指向第一個單元

說明

reset(array|object &$array): mixed

reset() 將 array 的內部指針倒回到第一個單元並返回第一個陣列單元的值。

參數

array: 輸入的陣列。

返回值

返回陣列第一個單元的值，如果陣列為空則返回 false。

警告

此函式可能返回布爾值 false，但也可能返回等同於 false 的非布爾值。請閱讀布爾型別章節以獲取更多資訊。應使用 === 運算子來測試此函式的返回值。

更新日誌

版本	說明
8.1.0	棄用在 object 上呼叫此函式。在 object 優先使用 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"

?>

註釋

注意: 返回的值無法區分是空陣列，還是第一個元素是 bool false。要正確檢測陣列第一個元素包含 false 的情況，首先要檢測陣列 count()，或在呼叫 reset() 后檢測 key() 不為 null。

參見

current() - 返回陣列中的當前值
each() - 返回陣列中目前的鍵／值對並將陣列指針向前移動一步
end() - 將陣列的內部指針指向最後一個單元
next() - 將陣列中的內部指針向前移動一位
prev() - 將陣列的內部指針倒回一位
array_key_first() - 獲取指定陣列的第一個鍵

reset

說明

參數

返回值

更新日誌

範例

註釋

參見

發佈留言 取消回覆

發佈留言取消回覆