CKTIS / PHP
Промяна на размера на SplFixedArray чрез SplFixedArray::setSize
Промени размера на съществуващ `SplFixedArray`. Увеличаването добавя позиции със стойност `null`, а намаляването премахва стойности от края на масива.
Версия: PHP 8.3
Синтаксис
PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.SplFixedArray::setSize променя размера на съществуващ обект от SPL, без да създава нов. Това е метод на екземпляр: извикай го като $array->setSize($size). Аргументът $size от тип int задава желания брой позиции, а не броя за добавяне или последния индекс. При положителен размер индексите са от 0 до $size - 1.
При увеличаване текущите стойности се запазват, а новите позиции получават стойност null. При намаляване се запазват стойностите с индекси, по-малки от $size, а останалите се премахват. Повторното увеличаване не ги възстановява. Размер 0 премахва всички позиции. Ако размерът не се промени, съдържанието остава същото.
В PHP 8.3 предварителният тип на връщаната стойност е bool, но при нормално приключване методът връща true, а не новия размер. За да прочетеш размера, използвай $array->getSize(). От PHP 8.4 предварителният тип на връщаната стойност е true. При отрицателен размер се хвърля ValueError. PHP_INT_MAX е горната граница на типа int, а не гаранция, че има достатъчно памет за толкова позиции.
Примери
<?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";
}
Резултат
[true,3,10,null] 1 [2,10,null] ValueError
Първият ред показва върнатата стойност `true`, размера `3`, запазената стойност `10` и нова позиция със стойност `null`. След намаляване до `1` и повторно увеличаване до `2` на индекс `1` има `null`, а не предишната стойност `20`. Последният ред се извежда при прихващане на `ValueError`.
Свързани уроци
- PHP · Урок 66 · Напреднало · Версия: 2