end
(PHP 4, PHP 5, PHP 7, PHP 8)
end — Define o ponteiro interno de um array para seu último elemento
Descrição
end() avança o ponteiro interno de array
até o último elemento, e retorna seu valor.
Parâmetros
array
-
O array. Este array é passado por referência porque ele é modificado pela função. Isto significa que deve-se passar a esta função uma variável real, e não uma função retornando um array, porque somente variáveis reais podem ser passadas por referência.
Valor Retornado
Retorna o valor do último elemento ou false
para array vazio.
Registro de Alterações
Versão | Descrição |
---|---|
8.1.0 | Chamar esta função em objects tornou-se defasado. Converta o object para um array usando get_mangled_object_vars() primeiro ou, em vez disso, use os métodos fornecidos por uma classe que implementa Iterator, como ArrayIterator. |
7.4.0 | Instâncias de classes SPL agora são tratadas como objetos vazios que não possuem propriedades em vez de chamar o método da interface Iterator com o mesmo nome desta função. |
Exemplos
Example #1 Exemplo de end()
<?php
$frutas = array('melancia', 'banana', 'morango');
echo end($frutas); // morango
?>
Veja Também
- current() - Retorna o elemento atual em um array
- each() - Retorna o par atual de chave e valor de um array e avança o seu cursor
- prev() - Retrocede o ponteiro interno de um array
- reset() - Faz o ponteiro interno de um array apontar para o seu primeiro elemento
- next() - Avança o ponteiro interno de um array
- array_key_last() - Obtém a última chave de um array