end

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

endDefine o ponteiro interno de um array para seu último elemento

Descrição

end(array|object &$array): mixed

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