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

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(): array

SplFixedArray::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

Fontes