CKTIS / PHP
SplFixedArray::toArray — Converter num array nativo de PHP
`toArray()` devolve um array nativo de PHP com todas as posições, incluindo as que têm o valor `null`, sem alterar o objeto original.
Versão: PHP 8.3
Sintaxe
public function toArray(): arraySplFixedArray::toArray é um método público de instância da classe \SplFixedArray da SPL. A SPL está sempre ativa nas compilações padrão do PHP 8.3. Chama o método sobre um objeto com ->: $fixed->toArray(). O método não recebe argumentos e devolve um array, não um objeto SplFixedArray.
O resultado preserva a ordem e os índices inteiros a partir de 0. As posições a que não atribuíste um valor continuam presentes com o valor null; o método não as ignora. Se o tamanho do array fixo for zero, o método devolve [].
Usa este método quando o código espera um array ou quando queres acrescentar elementos com [] sem redimensionar o objeto original. Substituir um valor escalar ou acrescentar um elemento no resultado não altera a origem. No entanto, não é uma cópia profunda: se um elemento contiver um objeto, as alterações às suas propriedades feitas através do resultado também são visíveis através da origem.
Exemplos
<?php
$fixed = new \SplFixedArray(3);
$fixed[0] = 12;
$fixed[2] = 30;
$values = $fixed->toArray();
echo json_encode($values), "\n";
$values[0] = 99;
$values[] = 40;
echo json_encode($values), "\n";
echo json_encode($fixed->toArray()), "\n";
Resultado
[12,null,30] [99,null,30,40] [12,null,30]
A primeira linha mostra que o índice `1` continua a ter o valor `null`. A segunda mostra o valor substituído no índice `0` e o elemento acrescentado. A terceira mostra que o objeto original não foi alterado. `json_encode()` é usado apenas para apresentar o resultado.
Lições relacionadas
- PHP · Lição 66 · Avançado · Versão: 2