Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

Parametr przekazywany przez referencję (`&$projects`)

Zapis `&$projects` pozwala funkcji zmienić zmienną przekazaną przez wywołującego. Znak `&` umieszcza się w deklaracji parametru, nie w wywołaniu.

Wersja: PHP 8.3; extension availability may vary

Składnia

function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');

W PHP 8.3 zapis array &$projects deklaruje parametr przekazywany przez referencję. Podczas wywołania $projects w funkcji i $activeProjects u wywołującego są dwiema nazwami tej samej zawartości. Zarówno dopisanie elementu przez $projects[] = $name, jak i przypisanie całej nowej tablicy do $projects zmienia zmienną wywołującego. Zmiana jest widoczna po powrocie z funkcji; void oznacza, że funkcja nie zwraca wyniku.

Znak & umieszcza się tylko w deklaracji parametru. Wywołaj addProject($activeProjects, 'Beacon') bez &. Przekaż zainicjalizowaną zmienną zamiast literału tablicowego, takiego jak [], którego przekazanie w tym miejscu jest błędem. Wynik funkcji zwracającej przez referencję też może być argumentem; zwykły wynik zwrócony przez wartość nie zastępuje zmiennej.

PHP sprawdza typ array przy wejściu do funkcji, a nie przy wyjściu. Jeśli zainicjalizowana zmienna zawiera wartość, która nie jest tablicą, wywołanie zgłosi TypeError. Sama deklaracja parametru nie gwarantuje jednak, że funkcja pozostawi w zmiennej tablicę.

Bez & argument jest domyślnie przekazywany przez wartość: dopisanie elementu w tym przykładzie zmieniłoby tylko lokalną tablicę. Używaj referencji, gdy zmiana zmiennej wywołującego jest zamierzona, i udokumentuj ten efekt. Jeśli zmienna ma pozostać bez zmian, przekaż tablicę przez wartość i zwróć zmienioną wersję.

Przykłady

<?php
function addProject(array &$projects, string $name): void
{
    $projects[] = $name;
}

$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";

Wynik

Atlas
Atlas, Beacon

Pierwszy wiersz pokazuje stan przed wywołaniem. Drugi pokazuje, że do zmiennej `$activeProjects` dopisano `Beacon`, mimo że `addProject()` nie zwraca wyniku.

Powiązane lekcje

  • PHP · Lekcja 12 · Średniozaawansowany · Wersja: 3
  • PHP · Lekcja 13 · Średniozaawansowany · Wersja: 3

Źródła