Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

Percorrer um array por referência com foreach e &$p

Usa `&$p` para alterar diretamente os elementos de um array num ciclo `foreach`. A seguir, executa `unset($p)` para evitar que uma atribuição posterior sobrescreva um elemento.

Versão: PHP 8.3

Sintaxe

foreach ($items as &$p) {
    // Read or modify the current element through $p.
}
unset($p);

// With a key:
foreach ($items as $key => &$p) {
    // $key receives the key; $p refers to the element's value.
}
unset($p);

Em PHP 8.3, foreach ($items as &$p) associa $p ao elemento atual do array em cada iteração. Atribuir um valor a $p altera, portanto, o próprio elemento. O sinal & indica uma referência: outro nome para aceder ao mesmo valor, e não um ponteiro. Em foreach ($items as $key => &$p), $key recebe a chave e apenas o valor é associado por referência.

Por outro lado, foreach ($items as $p) atribui cada valor a $p sem associar a variável ao elemento atual. Se $p ainda não for uma referência, uma atribuição simples a $p não substitui nenhum elemento do array.

Quando um ciclo sobre um array não vazio termina normalmente, $p continua a referir-se ao último elemento. Executa unset($p) logo a seguir ao ciclo: elimina a ligação, não o elemento. Sem isso, até um ciclo posterior por valor que reutilize $p sem & pode sobrescrever o último elemento a cada atribuição, sem aviso.

Exemplos

<?php
$items = [1, 2, 3];

foreach ($items as &$p) {
    $p *= 2;
}
unset($p);

$sum = 0;
foreach ($items as $p) {
    $sum += $p;
}

echo implode(', ', $items), "\n", $sum, "\n";

Resultado

2, 4, 6
12

O primeiro ciclo duplica os elementos. Depois de `unset($p)`, o segundo soma-os sem alterar o array. Se removeres apenas `unset($p);`, as linhas esperadas passam a ser `2, 4, 4` e `10`, em vez de `2, 4, 6` e `12`.

Lições relacionadas

  • PHP · Lição 20 · Avançado · Versão: 2

Fontes