Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

Redimensionar un SplFixedArray con SplFixedArray::setSize

Cambia el tamaño de un `SplFixedArray` existente. Al ampliarlo se añaden posiciones con `null`; al reducirlo se descartan los valores del final.

Versión: PHP 8.3

Sintaxis

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

SplFixedArray::setSize cambia el tamaño de un objeto de SPL existente sin crear otro. Es un método de instancia: llámalo con $array->setSize($size). El argumento $size, de tipo int, indica el número de posiciones que quieres obtener, no cuántas añadir ni el último índice. Con un tamaño positivo, los índices van de 0 a $size - 1.

Al ampliar el tamaño se conservan los valores existentes y las posiciones nuevas se inicializan con null. Al reducirlo se conservan los valores con índices inferiores a $size y se descartan los demás. Volver a ampliarlo no recupera esos valores. El tamaño 0 elimina todas las posiciones. Si el tamaño no cambia, el contenido tampoco.

En PHP 8.3 el tipo de retorno provisional es bool, pero al completarse normalmente la llamada devuelve true, no el tamaño nuevo. Para consultar el tamaño, usa $array->getSize(). Desde PHP 8.4 el tipo de retorno provisional es true. Un tamaño negativo provoca un ValueError. PHP_INT_MAX es el límite superior de int, no una garantía de que haya memoria suficiente para tantas posiciones.

Ejemplos

<?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

La primera línea muestra el retorno `true`, el tamaño `3`, el valor conservado `10` y una posición nueva con `null`. Tras reducir a `1` y volver a ampliar a `2`, el índice `1` contiene `null`, no el antiguo `20`. La última línea se imprime al capturar `ValueError`.

Lecciones relacionadas

  • PHP · Lección 66 · Avanzado · Versión: 2

Fuentes