База знанияИзпитен център
BGБългарски
Избери език13

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

Източници