Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

Parametr předávaný odkazem (`&$list`)

Znak `&` před `$list` umožňuje funkci v PHP změnit proměnnou volajícího. Píše se do deklarace parametru, nikoli před argument při volání funkce.

Verze: PHP 8.3

Syntaxe

<?php
function appendItem(array &$list, string $item): void
{
    $list[] = $item;
}

$items = ['apple'];
appendItem($items, 'pear');

V PHP 8.3 označuje &$list parametr předávaný odkazem. Při volání appendItem($items, 'pear') se místní jméno $list stane aliasem stejného obsahu, ke kterému přistupuje $items. Odkaz v PHP není ukazatel na adresu v paměti. $list je běžný název parametru a nesouvisí s konstrukcí list() pro rozklad pole.

Syntaxe odkazů, operace s poli ani funkce implode() použité v příkladu nevyžadují žádné volitelné rozšíření PHP.

Znak & napiš před název parametru v deklaraci, nikoli před argument při volání. Předej proměnnou, například $items; předání literálu jako ['apple'] tomuto parametru je chyba. Předat lze i výsledek vrácený odkazem. Přijetí argumentu odkazem neznamená vracení výsledku odkazem.

$list[] = $item přidá prvek do pole volajícího a $list = [] by nahradilo celé pole. Změny zůstanou viditelné i po návratu z funkce. Naproti tomu unset($list) uvnitř funkce zruší jen místní vazbu, nikoli proměnnou $items. Bez & se argument ve výchozím nastavení předává hodnotou, takže uvedené přidání prvku by $items nezměnilo.

U array &$list PHP kontroluje typ array při vstupu do funkce, ne při návratu. Předání proměnné obsahující celé číslo vyvolá TypeError. void se týká návratové hodnoty, ne změny argumentu. Odkaz použij, když chceš proměnnou volajícího záměrně změnit. Tento vedlejší účinek zdokumentuj, protože ze samotného volání není patrný.

Příklady

<?php
function appendItem(array &$list, string $item): void
{
    $list[] = $item;
}

$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";

Výsledek

apple, pear

Po volání `appendItem()` skript vypíše `$items`, nikoli návratovou hodnotu funkce. Očekávaný řádek je `apple, pear`. Pro srovnání odstraň z deklarace parametru pouze `&`: očekávaný řádek pak bude `apple`.

Související lekce

  • PHP · Lekce 20 · Středně pokročilá · Verze: 3

Zdroje