KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Arrayparameter door verwijzing: `array &$items`

`array &$items` vereist een array aan het begin van de aanroep en laat de functie de variabele van de aanroeper wijzigen zonder een resultaat terug te geven.

Versie: PHP 8.3; extension availability may vary

Syntax

function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);

In function markReady(array &$items): void legt array het invoertype vast, is $items de lokale parameternaam en staat & voor doorgeven door verwijzing. De parameter is een alias voor de variabele van de aanroeper: zowel schrijven naar $items[0] als een nieuwe waarde toewijzen aan $items is zichtbaar voor de aanroeper, ook met : void.

Initialiseer een variabele met een array en roep markReady($cart) aan. Het teken & staat in de declaratie, niet bij de aanroep. Geef geen arrayliteral zoals ['draft'] of een normaal per waarde geretourneerd functieresultaat rechtstreeks door; een per verwijzing geretourneerd resultaat mag wel. Bevat de doorgegeven variabele geen array, dan gooit PHP bij binnenkomst een TypeError. Bij terugkeer wordt het type niet opnieuw gecontroleerd, dus een toewijzing via $items kan zelfs het type van een gewone variabele van de aanroeper veranderen.

Zonder & wordt array $items per waarde doorgegeven: het vervangen van een element met een gewone tekenreeks, zoals in het voorbeeld, verandert de array van de aanroeper niet. Dat is geen diepe kopie: bestaande verwijzingen in de array kunnen nog steeds waarden delen. Als mutatie niet bij het contract van de functie hoort, geef de array dan per waarde door en retourneer het resultaat expliciet.

unset($items) verwijdert de lokale binding, niet de variabele van de aanroeper. foreach ($items as &$item) maakt daarentegen een afzonderlijke verwijzing naar een element. Gebruik na zo’n lus unset($item), zodat een latere toewijzing aan $item het laatst bezochte element niet overschrijft.

Voorbeelden

<?php
function markReadyCopy(array $items): void
{
    $items[0] = 'ready';
}

function markReady(array &$items): void
{
    $items[0] = 'ready';
}

$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";

markReady($cart);
echo $cart[0], "\n";

Resultaat

draft
ready

Beide functies schrijven `ready` op index `0`. Na de aanroep per waarde bevat `$cart[0]` nog `draft`; na de aanroep per verwijzing bevat het `ready`.

Gerelateerde lessen

  • PHP · Les 19 · Gevorderd · Versie: 2

Bronnen