CKTIS / PHP
Параметър, предаван по референция: `&$res`
Знакът `&` пред `$res` позволява на функцията да промени подадената променлива, вместо да върне нова стойност, която извикващият код да запише в нея.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);В сигнатура на функция &$res означава параметър, предаван по референция. По време на извикването локалното име $res е друго име за променливата на извикващия код. За разлика от обичайното предаване по стойност, присвояването на $res променя тази променлива. res е обикновено име, а не ключова дума; тук & не означава нито указател, нито връщане по референция.
Постави & в декларацията, а не при извикването: writeSum(2, 3, $total). За аргумента, предаван по референция, използвай променлива, а не литерал като 0 или изчисляем израз като 2 + 3. Можеш да подадеш и референция, върната от функция, декларирана да връща по референция.
В PHP 8.3 типът в int &$res се проверява при влизане във функцията, но не отново при излизане. Затова само декларацията не гарантира, че след извикването променливата ще продължи да съдържа стойност от тип int. unset($res) във функцията премахва само локалната връзка, а не променливата на извикващия код.
Документирай кои аргументи функцията може да презапише. Ако ти трябва само един резултат и не е необходимо да променяш променливата на извикващия код, обикновеният return обикновено е по-ясен. Този синтаксис е част от езика PHP и не изисква допълнително разширение.
Примери
<?php
declare(strict_types=1);
function writeSum(int $left, int $right, int &$res): void
{
$res = $left + $right;
}
$total = 0;
echo "before: ", $total, "\n";
writeSum(2, 3, $total);
echo "after: ", $total, "\n";
Резултат
before: 0 after: 5
Първоначално `$total` има стойност `0`. Присвояването чрез `$res` я променя на `5`, въпреки че `writeSum()` е с тип на връщане `void` и не връща резултат.
Свързани уроци
- PHP · Урок 70 · Напреднало · Версия: 2