CKTIS / PHP
Параметър, предаван по референция (`&$st`)
Знакът `&` пред името на параметъра позволява на функцията да промени променлива от извикващия код. Напиши `&$st` в декларацията, а при извикване подай променливата без `&`: `markReady($status)`.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function markReady(string &$st): void { $st .= '!'; }
markReady($status);В PHP 8.3 записът string &$st означава, че аргументът се предава по референция. Във функцията $st е локален псевдоним на $status от извикващия код: двете имена обозначават една и съща стойност. Записът чрез $st затова променя $status, а промяната остава видима и след края на функцията. Без & аргументът по подразбиране се предава по стойност и присвояването на параметъра не променя променливата в извикващия код.
Постави & пред името на параметъра в декларацията, а не при извикването. Подай инициализирана променлива, както в markReady($status). Литералът в markReady('Ready') не е променлива и води до грешка. Не подавай и обикновени изрази, които изчисляват стойност; резултат от функция, която връща по референция, е отделен допустим случай.
Типът string на параметъра се проверява при влизане във функцията, но не и повторно при излизане. : void означава, че функцията не връща стойност; ефектът се вижда в подадената променлива. Използвай &, когато умишлено искаш да промениш тази променлива, и документирай това поведение, защото то не личи от самото извикване.
Примери
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Резултат
Ready Ready!
На първия ред се извежда `Ready`. Функцията добавя `!` чрез `$st`, затова на втория ред се извежда `Ready!`. Ако премахнеш само `&` от декларацията, и на двата реда ще се извежда `Ready`.
Свързани уроци
- PHP · Урок 34 · Средно · Версия: 3