CKTIS / PHP
Parameter die per referentie wordt doorgegeven (&$users)
Met `&` vóór de parameter `$users` kan een functie de variabele van de aanroeper wijzigen zonder de array terug te geven. Bij de aanroep geef je de variabele zonder `&` door.
Versie: PHP 8.3; extension availability may vary
Syntax
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');In array &$users geeft array het type van het argument aan en markeert & doorgifte per referentie. De lokale parameter en de variabele van de aanroeper zijn twee namen voor dezelfde waarde. & staat hier niet voor een pointer of een bitsgewijze AND-operator, en de functie geeft geen referentie terug.
Roep addUser($users, 'Lin') aan zonder & en geef een geïnitialiseerde variabele door. Een door een functie teruggegeven referentie mag ook, maar een arrayliteral niet: addUser(['Ada'], 'Lin') leidt tot een Error. PHP controleert het type array bij het begin van de functie, niet bij terugkeer. Een variabele die een tekenreeks bevat, leidt tot een TypeError.
$users[] = $name voegt achteraan een element toe. Een gewone toewijzing zoals $users = [] zou de hele waarde van de variabele van de aanroeper vervangen. De wijziging blijft na de aanroep zichtbaar, ook al geeft de functie geen waarde terug (void). Zonder & wordt de array standaard per waarde doorgegeven en verandert de toevoeging in dit voorbeeld alleen de lokale array.
Gebruik & als je de variabele van de aanroeper bewust wilt wijzigen. Documenteer dat effect, want in de aanroep zelf zie je het niet. Als de aanroeper zelf moet beslissen of de array wordt vervangen, neem de array dan per waarde aan en geef de gewijzigde array terug.
Voorbeelden
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Resultaat
Ada Ada, Lin
Het voorbeeld gebruikt PHP 8.3 op de opdrachtregel en heeft geen optionele extensies nodig. Verwacht vóór de aanroep `Ada` en erna `Ada, Lin`. Verwijder je alleen `&` uit de declaratie, dan verwacht je op beide regels `Ada`.
Gerelateerde lessen
- PHP · Les 28 · Gemiddeld · Versie: 3