end

(PHP 4, PHP 5, PHP 7, PHP 8)

end — Establece el puntero interno de un array a su último elemento

Descripción

end(array &$array): mixed

end() avanza el puntero interno del array hasta su último elemento y devuelve su valor.

Parámetros

array: El array. Este array es pasado por referencia porque es modificado por la función. Esto significa que se debe pasar una variable real y no una función que devuelve un array porque solamente variables puede ser pasadas por referencia.

Valores devueltos

Devuelve el valor del último elemento o false si el array está vacío.

Ejemplos

Ejemplo #1 Ejemplo de end()

<?php

$fruits = array('manzana', 'plátano', 'arándano');
echo end($fruits); // arándano

?>

Ver también

current() - Devuelve el elemento actual en un array
each() - Devolver el par clave/valor actual de un array y avanzar el cursor del array
prev() - Rebobina el puntero interno del array
reset() - Establece el puntero interno de un array a su primer elemento
next() - Avanza el puntero interno de un array
array_key_last() - Obtiene la última clave de un array

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

135

franz at develophp dot org ¶

14 years ago

It's interesting to note that when creating an array with numeric keys in no particular order, end() will still only return the value that was the last one to be created. So, if you have something like this:



    <?php

    $a = array();

    $a[1] = 1;

    $a[0] = 0;

    echo end($a);

    ?>



This will print "0".

down

jasper at jtey dot com ¶

18 years ago

This function returns the value at the end of the array, but you may sometimes be interested in the key at the end of the array, particularly when working with non integer indexed arrays:

<?php
// Returns the key at the end of the array
function endKey($array){
 end($array);
 return key($array);
}
?>

Usage example:
<?php
$a = array("one" => "apple", "two" => "orange", "three" => "pear");
echo endKey($a); // will output "three"
?>

down

jorge at REMOVETHIS-2upmedia dot com ¶

12 years ago

If all you want is the last item of the array without affecting the internal array pointer just do the following:

<?php

function endc( $array ) { return end( $array ); }

$items = array( 'one', 'two', 'three' );
$lastItem = endc( $items ); // three
$current = current( $items ); // one
?>

This works because the parameter to the function is being sent as a copy, not as a reference to the original variable.

down

Anonymous ¶

22 years ago

If you need to get a reference on the first or last element of an array, use these functions because reset() and end() only return you a copy that you cannot dereference directly:



<?php

function first(&$array) {

if (!is_array($array)) return &$array;

if (!count($array)) return null;

reset($array);

return &$array[key($array)];

}



function last(&$array) {

if (!is_array($array)) return &$array;

if (!count($array)) return null;

end($array);

return &$array[key($array)];

}

?>

down

ivijan dot stefan at gmail dot com ¶

10 years ago

I found that the function end() is the best for finding extensions  on file name. This function cleans backslashes and takes the extension of a file.

<?php
private function extension($str){
    $str=implode("",explode("\\",$str));
    $str=explode(".",$str);
    $str=strtolower(end($str));
     return $str;
}

// EXAMPLE:
$file='name-Of_soMe.File.txt';
echo extension($file); // txt
?>

Very simple.

＋add a note