(PHP 4, PHP 5, PHP 7, PHP 8)
prev — Retrocede o ponteiro interno de um array
Retrocede o ponteiro interno do array.
prev() funciona como next(), exceto que ela retrocede o ponteiro interno do array ao invés de avançá-lo.
array
O array de entrada.
Retorna o valor do array que está na posição anterior à posição apontada pelo ponteiro interno, ou false
se não houver mais elementos.
Esta função pode retornar o valor booleano false
, mas também pode retornar um valor não booleano que pode ser avaliado como false
. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.
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. |
Exemplo #1 Exemplo de uso de prev() e funções relacionadas
<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport); // $mode = 'bike';
$mode = next($transport); // $mode = 'car';
$mode = prev($transport); // $mode = 'bike';
$mode = end($transport); // $mode = 'plane';
?>
Nota: Você não conseguirá distinguir o começo de um array de um elemento bool
false
. Para conseguir identificar o início do array, veja se key() do elemento prev() não sejanull
.