KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Arrayparameter doorgeven per referentie: `array &$product`

`array &$product` vereist bij de aanroep een array en laat de functie de variabele van de aanroeper wijzigen zonder de array terug te geven.

Versie: PHP 8.3; extension availability may vary

Syntax

function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);

In function restock(array &$product): void geeft array het invoertype aan, staat & voor doorgeven per referentie en is $product de lokale parameternaam. De referentie geldt voor de variabele die de hele array bevat; de array-elementen worden daardoor geen referenties.

Wijs vóór de aanroep restock($item) aan $item een array toe met een numerieke waarde onder de sleutel stock, bijvoorbeeld ['stock' => 3]. De & hoort in de declaratie, niet bij de aanroep. Een arrayliteral is geen geldig argument voor deze parameter. Een functie die een array per referentie retourneert, kan wel een geldig argument leveren.

$product en $item verwijzen naar dezelfde waarde. De functie kan een element wijzigen of de hele array vervangen, en de wijziging blijft na de aanroep zichtbaar. : void betekent dat er geen retourwaarde is, niet dat er geen bijwerkingen zijn. Zonder & wordt de parameter per waarde doorgegeven en blijft dezelfde wijziging aan een gewoon element lokaal. Elementen die al referenties zijn, kunnen wel gedeeld blijven.

PHP controleert bij binnenkomst in de functie of de doorgegeven variabele een array bevat en gooit anders een TypeError. PHP controleert geen sleutels of elementtypen en controleert het parametertype niet opnieuw bij het verlaten van de functie. Een lege array komt dus door de typecontrole, maar PHP 8.3 geeft een waarschuwing wanneer += de ontbrekende sleutel stock probeert te lezen. Wijzig je een gewone variabele, zorg dan dat die een array blijft bevatten als de aanroepende code dat verwacht.

Voorbeelden

<?php

function restock(array &$product): void
{
    $product['stock'] += 2;
}

$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";

Resultaat

3
5

De uitvoer is eerst `3` en dan `5`. De functie telt `2` op bij `$product['stock']`. Daardoor is `$item['stock']` na de aanroep `5`, ook al retourneert de functie geen waarde.

Gerelateerde lessen

  • PHP · Les 20 · Gevorderd · Versie: 2

Bronnen