reset

(PHP 4, PHP 5, PHP 7)

reset - 将数组的内部指针设置为其第一个元素

描述

mixed reset ( array &$array )

reset（）将array内部指针回退到第一个元素并返回第一个数组元素的值。

参数

array

输入数组。

返回值

返回第一个数组元素的值，或者FALSE数组是空的。

警告

该函数可能返回布尔值FALSE，但也可能返回一个非布尔值，其值为FALSE。有关更多信息，请阅读布尔部分。使用===运算符来测试此函数的返回值。

例子

示例＃1 reset（）示例

<?php

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

// by default, the pointer is on the first element
echo current($array) . "<br />\n"; // "step one"

// skip two steps
next($array
next($array
echo current($array) . "<br />\n"; // "step three"

// reset pointer, start again on step one
reset($array
echo current($array) . "<br />\n"; // "step one"

?>

笔记

注意：如果数组具有布尔FALSE第一个元素，则空数组的返回值与返回值无法区分。要正确检查可能包含FALSE元素的数组的第一个元素的值，首先检查数组的count（），或者在调用reset（）后检查key（）与null是否严格不同。