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

CKTIS / PHP

Параметри, предавани по референция (&$tasks, &$used)

Знакът `&` пред `$tasks` и `$used` позволява на функцията да промени и двете променливи на извикващия код, без да ги връща.

Версия: PHP 8.3; extension availability may vary

Синтаксис

function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');

В PHP 8.3 знакът & се пише непосредствено пред името на параметъра в декларацията: array &$tasks, array &$used. При извикването addTask($tasks, $used, 'Review') не се пише &. Пред $name няма &, затова съответният аргумент се предава по стойност, както е по подразбиране.

По време на извикването всеки параметър, предаден по референция, е локално друго име за променливата, подадена от извикващия код. Промяната на елемент от масива или присвояването на нова стойност на параметъра променя тази променлива. Промените остават видими след извикването дори при тип на връщане void. Знакът & пред параметър не означава, че функцията връща по референция.

Най-лесно е да подаваш инициализирани променливи. Може да подадеш и резултат от функция, която връща по референция. Не подавай литерал като [] или резултат от обикновен израз вместо $tasks или $used. Литерал на това място предизвиква грешка.

Типът array се проверява при влизане във функцията: ако подадената променлива не съдържа масив, възниква TypeError. PHP не проверява повторно типовете на тези параметри при излизане. Документирай кои аргументи променя функцията, защото това не личи от извикването. Тази възможност не изисква допълнително разширение.

Примери

<?php

function addTask(array &$tasks, array &$used, string $name): void
{
    $tasks[] = $name;
    $used[$name] = true;
}

$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');

echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";

Резултат

Review
used

След извикването `$tasks[0]` съдържа `Review`, а `$used['Review']` има стойност `true`. Затова скриптът извежда `Review`, а на следващия ред — `used`.

Свързани уроци

  • PHP · Урок 12 · Начално · Версия: 2

Източници