배열 reset
(PHP 4, PHP 5, PHP 7, PHP 8)
reset — 배열의 내부 포인터를 첫 번째 요소로 설정
설명
reset(array|object &$array
): mixed
reset()은 array
의 내부 포인터를 첫 번째 요소로 되감고 첫 번째 배열 요소의 값을 반환합니다.
매개변수
array
- 입력 배열입니다.
반환 값
첫 번째 배열 요소의 값을 반환하거나 배열이 비어 있으면 false
를 반환합니다.
경고 이 함수는 부울 false
을 반환할 수 있지만 false
으로 평가되는 부울이 아닌 값을 반환할 수도 있습니다. 자세한 내용은 부울 섹션을 참조하세요. 이 함수의 반환 값을 테스트하려면 === 연산자를 사용하십시오.
변경 로그
버전 | 설명 |
---|---|
8.1.0 | 객체에서 이 함수를 호출하는 것은 더 이상 사용되지 않습니다. 먼저 객체에 get_mangled_object_vars()를 사용하거나 ArrayIterator를 사용하십시오. |
Examples
예제 #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) . "
\n"; // "step one"
// skip two steps
next($array);
next($array);
echo current($array) . "
\n"; // "step three"
// reset pointer, start again on step one
reset($array);
echo current($array) . "
\n"; // "step one"
?>
메모
참고: 빈 배열의 반환 값은 bool false
첫 번째 요소가 있는 배열의 경우 반환 값과 구별할 수 없습니다. false
요소를 포함할 수 있는 배열의 첫 번째 요소 값을 올바르게 확인하려면 먼저 배열의 count()를 확인하거나 reset()을 호출한 후 key()가 null
이 아닌지 확인하십시오.