CKTIS / PHP
Parameter, podan po referenci (`&$projects`)
Zapis `&$projects` funkciji omogoča, da spremeni spremenljivko klicatelja. Znak `&` zapišeš v deklaraciji parametra, ne pri klicu.
Različica: PHP 8.3; extension availability may vary
Sintaksa
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');V PHP 8.3 zapis array &$projects deklarira parameter, podan po referenci. Med klicem sta $projects v funkciji in $activeProjects v klicni kodi dve imeni za isto vsebino. Tako dodajanje elementa z $projects[] = $name kot prireditev novega polja spremenljivki $projects spremeni spremenljivko klicatelja. Sprememba ostane vidna tudi po koncu klica; void pomeni, da funkcija ne vrne rezultata.
Znak & zapiši samo v deklaraciji parametra. Funkcijo pokliči kot addProject($activeProjects, 'Beacon'), brez &. Podaj inicializirano spremenljivko, ne literala polja, kot je [], saj ta na tem mestu povzroči napako. Podaš lahko tudi referenco, ki jo vrne funkcija; navadna vrnjena vrednost ni nadomestilo za spremenljivko.
PHP preveri tip array ob vstopu v funkcijo, ne ob izstopu. Če inicializirana spremenljivka ne vsebuje polja, klic sproži TypeError. Deklaracija parametra pa ne zagotavlja, da bo po koncu funkcije v spremenljivki še vedno polje.
Brez & se argument privzeto poda po vrednosti: dodajanje elementa bi v tem primeru spremenilo le lokalno polje. Uporabi referenco, kadar želiš spremeniti spremenljivko klicatelja, in ta učinek dokumentiraj. Če mora spremenljivka ostati nespremenjena, podaj polje po vrednosti in vrni posodobljeno polje.
Primeri
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Rezultat
Atlas Atlas, Beacon
Prva vrstica pokaže stanje pred klicem. Druga pokaže, da je bil `Beacon` dodan v `$activeProjects`, čeprav `addProject()` ne vrne rezultata.
Povezane lekcije
- PHP · Lekcija 12 · Srednja · Različica: 3
- PHP · Lekcija 13 · Srednja · Različica: 3