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

CKTIS / PHP

Parametr typu pole předávaný odkazem: `array &$product`

`array &$product` při volání vyžaduje pole a umožňuje funkci změnit proměnnou ve volajícím kódu, aniž by pole vracela.

Verze: PHP 8.3; extension availability may vary

Syntaxe

function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);

V deklaraci function restock(array &$product): void určuje array vstupní typ, & označuje předání odkazem a $product je místní název parametru. Odkaz se týká proměnné obsahující celé pole; z prvků pole nedělá odkazy.

Před voláním restock($item) přiřaď do $item pole s číselnou hodnotou pod klíčem stock, například ['stock' => 3]. Znak & patří do deklarace, ne do volání. Literál pole není pro tento parametr platným argumentem. Platný argument ale může poskytnout funkce, která vrací pole odkazem.

$product a $item odkazují na tutéž hodnotu. Funkce může změnit prvek nebo nahradit celé pole a změna zůstane viditelná i po volání. : void znamená, že funkce nemá návratovou hodnotu, nikoli že nemá vedlejší účinky. Bez & jde o předání hodnotou a stejná změna běžného prvku zůstane místní; prvky, které už jsou odkazy, však mohou zůstat sdílené.

PHP ověřuje typ array při vstupu do funkce a vyvolá TypeError, pokud předaná proměnná neobsahuje pole. Nekontroluje klíče ani typy prvků a při návratu z funkce typ parametru znovu neověřuje. Prázdné pole tedy kontrolou typu projde, ale PHP 8.3 vydá varování, když se operátor += pokusí přečíst hodnotu pod chybějícím klíčem stock. Pokud měníš běžnou proměnnou, ponech v ní pole, jestliže s tím volající kód počítá.

Příklady

<?php

function restock(array &$product): void
{
    $product['stock'] += 2;
}

$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";

Výsledek

3
5

Na výstupu je nejprve `3`, potom `5`. Funkce přičte `2` k `$product['stock']`, takže `$item['stock']` má po volání hodnotu `5`, ačkoli funkce žádnou hodnotu nevrací.

Související lekce

  • PHP · Lekce 20 · Pokročilá · Verze: 2

Zdroje