current

(PHP 4, PHP 5)

current — 배열의 현재 원소를 반환

설명

mixed current ( array &$array )

모든 배열은 "현재" 원소를 가리키는 내부 포인터를 갖는데, 이 내부 포인터는 배열에 삽입되어진 첫번째 원소로 초기화된다.

인수

array: 배열.

반환값

current() 함수는 단순히 현재 내부 포인터에서 가리키고 있는 배열 원소의 값을 반환한다. 어떤 방법으로든 그 포인터를 움직이지 않는다. 내부 포인터가 원소 목록의 끝에서 벗어난 곳을 가리키면, current()는 FALSE를 반환한다.

Warning

이 함수는 논리 FALSE를 반환하지만, 0이나 "" 등, 논리 FALSE로 취급할 수 있는 다른 값을 반환할 수 있습니다. 자세한 정보는 논리형 섹션을 참고하십시오. 이 함수의 반환값을 확인하려면 === 연산자를 이용하십시오.

예제

Example #1 current()의 용례와 관련 함수


<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport);    // $mode = 'foot';
$mode = end($transport);     // $mode = 'plane';
$mode = current($transport); // $mode = 'plane';

$arr = array();
var_dump(current($arr)); // bool(false)

$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>

주의

Note: 배열의 끝과 boolean FALSE 원소를 구별할 수 없습니다. FALSE 원소를 가지는 배열을 올바르게 따라가려면, each()를 참고하십시오.

참고

end() - 배열 내부 포인터가 마지막 원소를 가리키게 설정
key() - 배열에서 키를 가져옵니다
each() - 배열에서 현재 키와 값 쌍을 반환하고 배열 커서를 전진
prev() - 내부 배열 포인터를 후진
reset() - 배열의 내부 포인터를 첫 원소로 설정
next() - 배열의 내부 배열 포인터를 전진