current

Return the current element in an array

Syntax

current ( array $array ) : mixed

Parameters

array

The array.

Return

The current() function simply returns the value of the array element that's currently being pointed to by the internal pointer. It does not move the pointer in any way. If the internal pointer points beyond the end of the elements list or the array is empty, current() returns FALSE.

Warning: This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on Booleans for more information. Use the identity operator (===) for testing the return value of this function.

Examples

1

<?

$array = array('one', 'two', 'three', 'four');

$return = current($array);

echo $return;

?>
one

2

<?

$array = array('one', 'two', 'three', 'four');

next($array);
echo current($array) . PHP_EOL;

prev($array);
echo current($array) . PHP_EOL;

end($array);
echo current($array) . PHP_EOL;

reset($array);
echo current($array);

?>
two
one
four
one

3

<?

$array = array('one', 'two', 'three', 'four');

reset($array);
prev($array);

$return = current($array);

var_export($return);

?>
false

4

<?

$array = array('one', 'two', 'three', 'four');

end($array);
next($array);

$return = current($array);

var_export($return);

?>
false

5

<?

$array = array();

$return = current($array);

var_export($return);

?>
false
HomeMenu