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

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

Източници