array_pop

(PHP 4 , PHP 5)

array_pop -- Retira um elemento do final do array

Descrição

mixed array_pop ( array array )

array_pop() retira e retorna o último elemento de array, diminuindo array em um elemento. Se array estiver vazio (ou se não for um array), o valor NULL é retornado.

Nota: Esta função irá resetar() o ponteiro do array depois do uso.

Exemplo 1. Exemplo de array_pop()

<?php
$cesta
= array("laranja", "banana", "melancia", "morango");
$fruta = array_pop($cesta);
print_r($cesta);
?>

Depois disso, $cesta terá 3 elementos:

Array
(
    [0] => laranja
    [1] => banana
    [2] => melancia
)

e morango será passado para $fruta.

Atenção

Esta função pode retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser avaliado como FALSE, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

Veja também array_push(), array_shift(), e array_unshift().