CKTIS / PHP
Zmena veľkosti SplFixedArray pomocou SplFixedArray::setSize
Zmeň veľkosť existujúceho poľa `SplFixedArray`. Zväčšenie pridá pozície s hodnotou `null`, zmenšenie odstráni hodnoty na konci poľa.
Verzia: PHP 8.3
Syntax
PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.SplFixedArray::setSize mení veľkosť existujúceho objektu SPL namiesto vytvorenia nového. Je to inštančná metóda: volaj ju ako $array->setSize($size). Argument $size typu int udáva cieľový počet pozícií, nie prírastok ani posledný index. Pri kladnej veľkosti siahajú indexy od 0 po $size - 1.
Zväčšenie zachová doterajšie hodnoty a nové pozície vyplní hodnotou null. Zmenšenie zachová hodnoty na indexoch menších než $size a ostatné odstráni. Opätovné zväčšenie ich neobnoví. Veľkosť 0 odstráni všetky pozície. Ak sa veľkosť nezmení, obsah zostane rovnaký.
V PHP 8.3 je predbežný návratový typ bool, ale pri bežnom dokončení metóda vráti true, nie novú veľkosť. Veľkosť zistíš pomocou $array->getSize(). Od PHP 8.4 je predbežný návratový typ true. Záporná veľkosť vyvolá ValueError. PHP_INT_MAX je horná hranica typu int, nie záruka, že na toľko pozícií bude dosť pamäte.
Prí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ýsledok
[true,3,10,null] 1 [2,10,null] ValueError
Prvý riadok zobrazuje návratovú hodnotu `true`, veľkosť `3`, zachovanú hodnotu `10` a novú pozíciu s hodnotou `null`. Po zmenšení na `1` a opätovnom zväčšení na `2` je na indexe `1` hodnota `null`, nie pôvodná hodnota `20`. Posledný riadok sa vypíše pri zachytení `ValueError`.
Súvisiace lekcie
- PHP · Lekcia 66 · Pokročilá · Verzia: 2