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

CKTIS / PHP

Redimensionar um SplFixedArray com SplFixedArray::setSize

Altera o tamanho de um `SplFixedArray` existente. Ao aumentá-lo, são acrescentadas posições com `null`; ao reduzi-lo, são descartados os valores do fim.

Versão: PHP 8.3

Sintaxe

PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.

SplFixedArray::setSize altera o tamanho de um objeto SPL existente, sem criar outro. É um método de instância: chama-o com $array->setSize($size). O argumento $size, do tipo int, indica o número pretendido de posições, não o número a acrescentar nem o último índice. Para um tamanho positivo, os índices vão de 0 a $size - 1.

Ao aumentar o tamanho, os valores existentes mantêm-se e as novas posições são preenchidas com null. Ao reduzi-lo, mantêm-se os valores em índices inferiores a $size e descartam-se os restantes. Voltar a aumentar o tamanho não recupera esses valores. O tamanho 0 elimina todas as posições. Se o tamanho não mudar, o conteúdo mantém-se.

Em PHP 8.3, o tipo de retorno provisório é bool, mas, quando termina normalmente, o método devolve true, não o novo tamanho. Para consultar o tamanho, usa $array->getSize(). Desde o PHP 8.4, o tipo de retorno provisório é true. Um tamanho negativo dá origem a um ValueError. PHP_INT_MAX é o limite superior de int, não uma garantia de que exista memória suficiente para tantas posições.

Exemplos

<?php
declare(strict_types=1);

$array = new SplFixedArray(2);
$array[0] = 10;
$array[1] = 20;

$result = $array->setSize(3);
echo json_encode([$result, $array->getSize(), $array[0], $array[2]]), "\n";

$array->setSize(1);
echo $array->getSize(), "\n";

$array->setSize(2);
echo json_encode([$array->getSize(), $array[0], $array[1]]), "\n";

try {
    $array->setSize(-1);
} catch (ValueError $error) {
    echo "ValueError\n";
}

Resultado

[true,3,10,null]
1
[2,10,null]
ValueError

A primeira linha apresenta o valor devolvido `true`, o tamanho `3`, o valor preservado `10` e uma posição nova com `null`. Depois de reduzir o tamanho para `1` e de o voltar a aumentar para `2`, o índice `1` contém `null`, não o valor anterior `20`. A última linha é apresentada ao capturar `ValueError`.

Lições relacionadas

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

Fontes