Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

Změna velikosti SplFixedArray pomocí SplFixedArray::setSize

Změň velikost existujícího pole `SplFixedArray`. Zvětšením přidáš pozice s hodnotou `null`, zmenšením odstraníš hodnoty na konci pole.

Verze: PHP 8.3

Syntaxe

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

SplFixedArray::setSize mění velikost existujícího objektu SPL, aniž by vytvářela nový. Jde o instanční metodu: volej ji jako $array->setSize($size). Argument $size typu int udává cílový počet pozic, nikoli přírůstek ani poslední index. Při kladné velikosti sahají indexy od 0 do $size - 1.

Zvětšení zachová dosavadní hodnoty a nové pozice vyplní hodnotou null. Zmenšení zachová hodnoty na indexech menších než $size a ostatní odstraní. Opětovné zvětšení je neobnoví. Velikost 0 odstraní všechny pozice. Pokud se velikost nezmění, obsah zůstane stejný.

V PHP 8.3 je předběžný návratový typ bool, ale při běžném dokončení metoda vrací true, nikoli novou velikost. Velikost zjistíš pomocí $array->getSize(). Od PHP 8.4 je předběžný návratový typ true. Záporná velikost vyvolá ValueError. PHP_INT_MAX je horní mez typu int, nikoli záruka, že pro tolik pozic bude dost paměti.

Příklady

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

Výsledek

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

První řádek ukazuje návratovou hodnotu `true`, velikost `3`, zachovanou hodnotu `10` a novou pozici s hodnotou `null`. Po zmenšení na `1` a opětovném zvětšení na `2` je na indexu `1` hodnota `null`, nikoli původní `20`. Poslední řádek se vypíše při zachycení `ValueError`.

Související lekce

  • PHP · Lekce 66 · Pokročilá · Verze: 2

Zdroje