PHP | función actual()

La función current() es una función incorporada en PHP.

• Se utiliza para devolver el valor del elemento en una array a la que apunta actualmente el puntero interno.
• La función actual() no incrementa ni disminuye el puntero interno después de devolver el valor.
• En PHP, todas las arrays tienen un puntero interno. Este puntero interno apunta a algún elemento en esa array que se llama como el elemento actual de la array.
• Por lo general, el elemento actual es el primer elemento insertado en la array.

Sintaxis: 

current($array)

Parámetros: la función current() acepta un solo parámetro $array . Es la array de la que queremos encontrar el elemento actual.

Valores devueltos: Devuelve el valor del elemento en la array al que apunta actualmente el puntero interno. Si la array está vacía, la función actual() devuelve FALSO.

Ejemplos:  

Input : current(array("John", "b", "c", "d"))
Output : John
Explanation : Here as we see that input array contains 
many elements and the output is "John" because first 
element is John and current() function returns 
the element to which internal pointer is currently
pointing.

Input: current(array("abc", "123", "7"))
Output: abc

Los siguientes programas ilustran la función actual() en PHP:

Programa 1 : 

<?php
 
// input array
$arr = array("Ram", "Shita", "Geeta");
 
// Here current function returns the
//  first element of the array.
echo current($a);
 
?>

Producción: 

Ram

Programa 2 : 

<?php
 
$arr = array('Sham', 'Mac', 'Jhon', 'Adwin');
 
// Here current element is Sham.
echo current($arr)."\n";
 
// increment internal pointer to point
// to next element i.e, Mac
echo next($arr)."\n";
 
// printing the current element as
// for now current element is Mac.
echo current($arr)."\n";
 
// increment internal pointer to point
// to next element i.e, Jhon.
echo next($arr)."\n";
 
// increment internal pointer to point
// to next element i.e, Adwin.
echo next($arr)."\n";
 
// printing the current element as for
// now current element is Adwin.
echo current($arr)."\n";
 
?>

Producción: 

Sham
Mac
Mac
Jhon
Adwin
Adwin

Nota: La función actual() devuelve Falso cuando la array está vacía, es decir, no contiene ningún elemento, y también devuelve falso cuando el puntero interno se sale del límite, es decir, más allá del final del último elemento.

Referencia:  
http://php.net/manual/en/function.current.php