Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Ridimensionare uno SplFixedArray con SplFixedArray::setSize

Modifica la dimensione di uno `SplFixedArray` esistente. Aumentandola si aggiungono posizioni con `null`; riducendola si scartano i valori in coda.

Versione: PHP 8.3

Sintassi

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

SplFixedArray::setSize modifica la dimensione di un oggetto SPL esistente senza crearne uno nuovo. È un metodo di istanza: chiamalo con $array->setSize($size). L’argomento $size, di tipo int, indica il numero di posizioni desiderato, non l’incremento né l’ultimo indice. Con una dimensione positiva, gli indici vanno da 0 a $size - 1.

Aumentando la dimensione, i valori esistenti vengono mantenuti e le nuove posizioni assumono il valore null. Riducendola, si conservano i valori con indice minore di $size e si scartano gli altri. Un successivo aumento non li ripristina. La dimensione 0 elimina tutte le posizioni. Se la dimensione non cambia, il contenuto rimane invariato.

In PHP 8.3 il tipo di ritorno provvisorio è bool, ma il metodo restituisce true al termine di una chiamata normale, non la nuova dimensione. Per leggere la dimensione, usa $array->getSize(). Da PHP 8.4 il tipo di ritorno provvisorio è true. Una dimensione negativa provoca un ValueError. PHP_INT_MAX è il limite superiore di int, non una garanzia che ci sia memoria sufficiente per tante posizioni.

Esempi

<?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";
}

Risultato

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

La prima riga mostra il valore restituito `true`, la dimensione `3`, il valore conservato `10` e una nuova posizione con `null`. Dopo aver ridotto la dimensione a `1` e averla riportata a `2`, all’indice `1` c’è `null`, non il vecchio `20`. L’ultima riga viene stampata quando si intercetta `ValueError`.

Lezioni correlate

  • PHP · Lezione 66 · Avanzato · Versione: 2

Fonti