KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Parameters doorgeven via referentie (&$tasks, &$used)

Met `&` bij `$tasks` en `$used` kan de functie beide variabelen van de aanroeper wijzigen zonder ze terug te geven.

Versie: PHP 8.3; extension availability may vary

Syntax

function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');

In PHP 8.3 schrijf je & in de declaratie direct vóór elke parameternaam: array &$tasks, array &$used. In de aanroep addTask($tasks, $used, 'Review') laat je & weg. Bij $name staat geen &, dus dat argument wordt op de standaardmanier doorgegeven: als waarde.

Tijdens de aanroep is elke referentieparameter een lokale alias voor de variabele die de aanroeper heeft doorgegeven. Als je een array-element wijzigt of de parameter een nieuwe waarde toekent, verandert de variabele van de aanroeper. De wijzigingen blijven na de aanroep zichtbaar, ook bij retourtype void. Een & bij een parameter betekent niet dat de functie een referentie retourneert.

Doorgegeven variabelen vooraf initialiseren is het eenvoudigst. Je kunt ook het resultaat doorgeven van een functie die per referentie retourneert. Geef geen letterlijke waarde zoals [] of het resultaat van een gewone expressie door in plaats van $tasks of $used: een letterlijke waarde op die plek veroorzaakt een fout.

PHP controleert het type array bij aanvang van de functie. Geef je een variabele door die geen array bevat, dan volgt een TypeError. PHP controleert deze parametertypen niet opnieuw bij het verlaten van de functie. Documenteer welke argumenten de functie wijzigt, omdat je dit niet aan de aanroep ziet. Hiervoor is geen extra extensie nodig.

Voorbeelden

<?php

function addTask(array &$tasks, array &$used, string $name): void
{
    $tasks[] = $name;
    $used[$name] = true;
}

$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');

echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";

Resultaat

Review
used

Na de aanroep bevat `$tasks[0]` de waarde `Review` en is `$used['Review']` gelijk aan `true`. Het script toont daarom `Review` en op de volgende regel `used`.

Gerelateerde lessen

  • PHP · Les 12 · Basis · Versie: 2

Bronnen