Manual do PHP
Anterior | Capítulo 17. Funções | Próxima

# 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.

Anterior | Principal | Próxima
Argumentos de funções | Acima | Funções variáveis