CKTIS / PHP
Параметър от тип масив, предаван по референция: `array &$items`
`array &$items` изисква масив в началото на извикването и позволява на функцията да промени подадената променлива, без да връща резултат.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);В декларацията function markReady(array &$items): void думата array задава входния тип, $items е локалното име на параметъра, а & означава предаване по референция. Параметърът е друго име за променливата на извикващия код: както записът в $items[0], така и присвояването на нова стойност на $items се виждат от извикващия код, дори при : void.
Инициализирай променлива с масив и извикай markReady($cart). Знакът & се пише в декларацията, а не при извикването. Не подавай директно литерал на масив като ['draft'] или обикновен резултат, върнат по стойност; резултат, върнат по референция, може да се подаде. Ако подадената променлива не съдържа масив, PHP хвърля TypeError при влизане във функцията. Типът не се проверява отново при връщане, затова присвояването чрез $items може дори да промени типа на обикновена променлива в извикващия код.
Без & параметърът array $items се предава по стойност: замяната на елемент, съдържащ обикновен низ, както в примера, не променя масива на извикващия код. Това не е дълбоко копиране: съществуващите референции в масива могат и занапред да сочат към общи стойности. Ако промяната не е част от договора на функцията, приеми масива по стойност и върни резултата изрично.
unset($items) премахва локалната връзка, а не променливата в извикващия код. За разлика от това foreach ($items as &$item) създава отделна референция към елемент. Използвай unset($item) след такъв цикъл, за да не презапише по-късен запис в $item последния обходен елемент.
Примери
<?php
function markReadyCopy(array $items): void
{
$items[0] = 'ready';
}
function markReady(array &$items): void
{
$items[0] = 'ready';
}
$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";
markReady($cart);
echo $cart[0], "\n";
Резултат
draft ready
И двете функции записват `ready` на индекс `0`. След извикването с предаване по стойност `$cart[0]` все още съдържа `draft`; след извикването с предаване по референция съдържа `ready`.
Свързани уроци
- PHP · Урок 19 · Напреднало · Версия: 2