return

A Palavra-chave "return" do PHP: Um Guia Completo

Em PHP, a palavra-chave return encerra uma função e, opcionalmente, passa um valor de volta para quem a chamou. Este guia aborda sua sintaxe, exemplos práticos e comportamentos importantes.

Sintaxe

Veja a sintaxe básica para usar a palavra-chave return:

A sintaxe PHP da palavra-chave return

function myFunction() {
  $value = 10;
  return $value;
}

Neste exemplo, usamos a palavra-chave return para passar o valor de $value de volta a partir de myFunction().

Exemplos

Vejamos alguns exemplos práticos de como a palavra-chave return pode ser utilizada:

Exemplos da palavra-chave return em PHP

<?php

// Example 1
function addNumbers($a, $b)
{
  return $a + $b;
}

$result = addNumbers(2, 3);
echo $result . PHP_EOL;

// Example 2
function isPositive($num)
{
  if ($num > 0) {
    return true;
  } else {
    return false;
  }
}

if (isPositive(5)) {
  echo "The number is positive";
} else {
  echo "The number is negative";
}

Nestes exemplos, usamos a palavra-chave return para passar valores de funções e utilizá-los em outras partes do nosso código. Isso é útil para encapsular lógica e reutilizar resultados.

Além do uso básico, return pode encerrar uma função antecipadamente sem retornar um valor (return;), passar múltiplos valores por meio de um array (return [$a, $b];), ou retornar uma referência adicionando o prefixo & à variável na assinatura da função.

Benefícios

O uso da palavra-chave return traz vários benefícios, incluindo:

• Organização do código: Encerrar uma função de forma limpa e passar resultados de volta melhora a legibilidade e a estrutura.
• Reutilização: Funções que retornam valores podem ser reutilizadas em diferentes partes de um projeto, reduzindo a duplicação.

Conclusão

A palavra-chave return é essencial para controlar o fluxo de funções e passar resultados de volta ao seu código. Dominá-la ajudará você a escrever funções PHP mais limpas e reutilizáveis.

Prática