Retornando valores

Valores podem ser retornados utilizando a instrução opcional return. Qualquer tipo pode ser retornado, incluindo arrays e objetos. Isto faz com que as função termine sua execução imediatamente e passa o controle de volta para a linha de onde ela foi chamada. Veja a documentação da função return() para maiores informações.

Exemplo 17-9. O uso de return()

<?php
function quadrado ($num)
{
    return
$num * $num;
}
echo
quadrado (4);   // imprime '16'.
?>

Você não pode retornar múltiplos valores a partir de uma função, mas resultados similares podem ser devolvidos retornando por uma lista.

Exemplo 17-10. Retornando um array para devolver vários valores

<?php
function numeros_pequenos()
{
    return array (
0, 1, 2);
}
list (
$zero, $um, $dois) = numeros_pequenos();
?>

Para retornar uma referência de uma função, você precisa utilizar o operador de referência & tanto na declaração da função como quando assimilando o valor retornado para a variável.

Exemplo 17-11. Retornando uma referência de uma função

<?php
function &retorna_referencia()
{
    return
$alguma_referencia;
}

$nova_referencia =& retorna_referencia();
?>

Para mais detalhes sobre referências, leia a seção Referências.