return-käsky PHP:ssä

Oletetaan, että meillä on funktio, joka tulostaa näytölle annetun luvun neliön:

php<?php
  function func($num) {
    echo $num * $num;
  }
  
  func(3); // tulostaa 9
?>

Oletetaan, että haluamme tulostaa arvon näytölle, vain tallentaa sen johonkin muuttujaan, näin:

php<?php
  $res = func(3); // muuttujassa $res on nyt 9
?>

Tätä varten PHP:ssä on erityinen käsky return, jonka avulla voidaan määrittää funktion palauttama arvo. Sanalla palauttaa tarkoitetaan sitä arvoa, joka kirjoitetaan muuttujaan, jos funktion kutsu liitetään muuttujaan.

Joten, kirjoitetaan funktiomme uudelleen niin, että se ei tulosta tulosta näytölle, vaan palauttaa sen muuttujaan:

php<?php
  function func($num) {
    return $num * $num;
  }
?>

Tallennetaan nyt funktion tulos muuttujaan:

php<?php
  $res = func(3);
?>

Kun tiedot on tallennettu muuttujaan, ne voidaan esimerkiksi tulostaa näytölle:

php<?php
  $res = func(3);
  echo $res; // tulostaa 9
?>

Tai tiedot voidaan ensin muuttaa jotenkin, ja sitten tulostaa ne näytölle:

php<?php
  $res = func(3);
  $res = $res + 1;
  echo $res; // tulostaa 10
?>

Funktion tuloksella voidaan suorittaa toimintoja välittömästi ennen tallentamista muuttujaan:

php<?php
  $res = func(3) + 1;
  echo $res; // tulostaa 10
?>

Funktiota voidaan kutsua useita kertoja eri luvuille:

php<?php
  $res = func(2) + func(3);
  echo $res; // tulostaa 13
?>

Tulosta ei tarvitse tallentaa muuttujaan, vaan se voidaan tulostaa suoraan näytölle:

php<?php
  echo func(3); // tulostaa 9
?>