CKTIS / PHP
Referentieparameter `&$res`
Met `&` vóór `$res` kan een functie de variabele van de aanroeper wijzigen in plaats van een vervangende waarde terug te geven.
Versie: PHP 8.3; extension availability may vary
Syntax
function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);In een functiehandtekening geeft &$res aan dat een parameter per referentie wordt doorgegeven. Tijdens de aanroep is de lokale naam $res een alias voor de variabele van de aanroeper. Anders dan bij doorgeven per waarde verandert een toewijzing aan $res die variabele. res is een gewone naam, geen sleutelwoord; & duidt hier geen pointer aan en geeft ook niet aan dat de functie een referentie teruggeeft.
Zet & in de declaratie, niet in de aanroep: writeSum(2, 3, $total). Geef voor het referentieargument een variabele door, geen letterlijke waarde zoals 0 of berekende expressie zoals 2 + 3. Ook een referentie die een functie teruggeeft die daarvoor is gedeclareerd, mag je doorgeven.
In PHP 8.3 wordt het type in int &$res gecontroleerd bij het binnengaan van de functie, niet opnieuw wanneer die terugkeert. De declaratie alleen garandeert dus niet dat de variabele daarna nog een int bevat. Binnen de functie verbreekt unset($res) alleen de lokale binding; de variabele van de aanroeper blijft bestaan.
Leg vast welke argumenten de functie kan overschrijven. Als je maar één resultaat hoeft op te leveren en de variabele van de aanroeper niet hoeft te wijzigen, is een gewone return meestal duidelijker. Deze syntaxis maakt deel uit van PHP en vereist geen extra extensie.
Voorbeelden
<?php
declare(strict_types=1);
function writeSum(int $left, int $right, int &$res): void
{
$res = $left + $right;
}
$total = 0;
echo "before: ", $total, "\n";
writeSum(2, 3, $total);
echo "after: ", $total, "\n";
Resultaat
before: 0 after: 5
`$total` begint op `0`. De toewijzing via `$res` verandert de waarde in `5`, hoewel `writeSum()` het retourtype `void` heeft en geen resultaat teruggeeft.
Gerelateerde lessen
- PHP · Les 70 · Gevorderd · Versie: 2