Understanding PHP's current() Function: Retrieving the Current Array Element

PHP's current() function returns the value of the array element that the internal pointer currently points to, without moving the pointer.

Each array has an internal pointer that initially points to the first inserted element. The function takes a reference to an array as its sole parameter.

If the internal pointer is beyond the end of the array, current() returns FALSE.

Example usage:

<?php
$transport = array('foot','bike','car','plane');
$mode = current($transport); // returns 'foot'
$mode = next($transport);    // moves pointer, returns 'bike'
$mode = current($transport); // returns 'bike'
$mode = prev($transport);    // moves back, returns 'foot'
$mode = end($transport);     // moves to last element, returns 'plane'
$mode = current($transport); // returns 'plane'

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

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