CKTIS / PHP
Параметър, предаван по референция (&$users)
Знакът `&` пред параметъра `$users` позволява на функцията да промени променливата в извикващия код, без да връща масива. При извикване променливата се подава без `&`.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');В array &$users означението array задава типа на аргумента, а & указва предаване по референция. Локалният параметър и променливата в извикващия код са две имена за една и съща стойност. Тук & не означава указател или побитов оператор „И“, а функцията не връща референция.
Извикайте addUser($users, 'Lin') без & и подайте инициализирана променлива. Може да подадете и референция, върната от функция, но не и литерал на масив: addUser(['Ada'], 'Lin') предизвиква Error. PHP проверява типа array при влизане във функцията, но не и при излизане. Подаването на променлива, съдържаща низ, предизвиква TypeError.
$users[] = $name добавя елемент в края, докато обикновено присвояване като $users = [] би заменило цялата стойност на променливата в извикващия код. Промяната остава видима след извикването, въпреки че функцията не връща стойност (void). Без & масивът по подразбиране се предава по стойност и добавянето в примера променя само локалния масив.
Използвайте &, когато целта е да промените променливата в извикващия код, и документирайте този ефект, защото той не личи от самото извикване. Ако извикващият код трябва сам да реши дали да замени масива си, приемете го по стойност и върнете променения масив.
Примери
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Резултат
Ada Ada, Lin
Примерът използва PHP 8.3 от командния ред и не изисква допълнителни разширения. Очакваният изход е `Ada` преди извикването и `Ada, Lin` след него. Ако премахнете само `&` от декларацията, очаквайте `Ada` и на двата реда.
Свързани уроци
- PHP · Урок 28 · Средно · Версия: 3