CKTIS / PHP
Paramètres passés par référence (&$tasks, &$used)
Le signe `&` devant `$tasks` et `$used` permet à la fonction de modifier les deux variables de l’appelant sans les renvoyer.
Version : PHP 8.3; extension availability may vary
Syntaxe
function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');En PHP 8.3, placez & juste devant le nom du paramètre dans la déclaration : array &$tasks, array &$used. N’ajoutez pas de & dans l’appel addTask($tasks, $used, 'Review'). Comme $name n’a pas de &, son argument est passé par valeur, le mode par défaut.
Pendant l’appel, chaque paramètre par référence est un alias local de la variable fournie par l’appelant. Modifier un élément du tableau ou affecter une nouvelle valeur au paramètre modifie la variable de l’appelant. Les changements restent visibles après l’appel, même avec un type de retour void. Le & d’un paramètre ne signifie pas que la fonction renvoie une référence.
Le plus simple est de passer des variables initialisées. Un appel à une fonction qui renvoie par référence peut aussi fournir un argument. Ne passez ni un littéral comme [] ni le résultat d’une expression ordinaire à la place de $tasks ou de $used : un littéral à cet emplacement provoque une erreur.
Le type array est contrôlé à l’entrée dans la fonction : passer une variable qui ne contient pas un tableau déclenche une TypeError. PHP ne contrôle pas à nouveau ces types de paramètres au retour. Documentez les arguments que la fonction modifie, car rien ne l’indique dans l’appel. Aucune extension supplémentaire n’est nécessaire.
Exemples
<?php
function addTask(array &$tasks, array &$used, string $name): void
{
$tasks[] = $name;
$used[$name] = true;
}
$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');
echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";
Résultat
Review used
Après l’appel, `$tasks[0]` contient `Review` et `$used['Review']` vaut `true`. Le script affiche donc `Review`, puis `used` sur la ligne suivante.
Leçons associées
- PHP · Leçon 12 · Débutant · Version : 2