База знанияИзпитен център
BGБългарски
Избери език13

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

Източници