Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / PHP

Parameter tipa array, podan po referenci: `array &$items`

`array &$items` ob začetku klica zahteva polje in funkciji omogoča, da spremeni spremenljivko klicatelja, ne da bi vrnila rezultat.

Različica: PHP 8.3; extension availability may vary

Sintaksa

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

V deklaraciji function markReady(array &$items): void določa array vhodni tip, $items je lokalno ime parametra, & pa označuje podajanje po referenci. Parameter je drugo ime za spremenljivko klicatelja: tako zapis v $items[0] kot prireditev nove vrednosti v $items sta vidna klicatelju, tudi pri : void.

Spremenljivki priredi polje in pokliči markReady($cart). Znak & spada v deklaracijo, ne v klic. Ne podajaj neposredno literala polja, kot je ['draft'], ali običajnega rezultata funkcije, vrnjenega po vrednosti; rezultat, vrnjen po referenci, lahko podaš. Če podana spremenljivka ne vsebuje polja, PHP ob vstopu sproži TypeError. Ob vrnitvi tipa ne preveri znova, zato lahko prireditev prek $items spremeni celo tip običajne spremenljivke klicatelja.

Brez & se array $items poda po vrednosti: zamenjava elementa, ki vsebuje navaden niz, kot v primeru, ne spremeni polja klicatelja. To ni globoka kopija: obstoječe reference v polju si lahko še vedno delijo vrednosti. Če spreminjanje argumenta ni del pogodbe funkcije, sprejmi polje po vrednosti in izrecno vrni rezultat.

unset($items) odstrani lokalno vezavo, ne spremenljivke klicatelja. Zanka foreach ($items as &$item) pa ustvari ločeno referenco na element. Po taki zanki uporabi unset($item), da poznejši zapis v $item ne prepiše zadnjega obiskanega elementa.

Primeri

<?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";

Rezultat

draft
ready

Obe funkciji zapišeta `ready` na indeks `0`. Po klicu s podajanjem po vrednosti je v `$cart[0]` še vedno `draft`; po klicu s podajanjem po referenci je tam `ready`.

Povezane lekcije

  • PHP · Lekcija 19 · Napredna · Različica: 2

Viri