CKTIS / PHP
Spreminjanje velikosti SplFixedArray z metodo SplFixedArray::setSize
Spremeni velikost obstoječega polja `SplFixedArray`. Povečanje doda mesta z vrednostjo `null`, zmanjšanje pa odstrani vrednosti na koncu polja.
Različica: PHP 8.3
Sintaksa
PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.SplFixedArray::setSize spremeni velikost obstoječega objekta SPL, ne da bi ustvarila novega. To je metoda primerka: pokliči jo z $array->setSize($size). Argument $size tipa int določa želeno število mest, ne števila mest, ki jih želiš dodati, niti zadnjega indeksa. Pri pozitivni velikosti segajo indeksi od 0 do $size - 1.
Pri povečanju se obstoječe vrednosti ohranijo, nova mesta pa dobijo vrednost null. Pri zmanjšanju se ohranijo vrednosti na indeksih, manjših od $size, preostale pa se zavržejo. Ponovno povečanje jih ne obnovi. Velikost 0 odstrani vsa mesta. Če se velikost ne spremeni, ostane vsebina enaka.
V PHP 8.3 je začasni povratni tip bool, vendar metoda ob običajnem zaključku vrne true, ne nove velikosti. Velikost prebereš z $array->getSize(). Od PHP 8.4 je začasni povratni tip true. Negativna velikost sproži ValueError. PHP_INT_MAX je zgornja meja tipa int, ne zagotovilo, da je za toliko mest dovolj pomnilnika.
Primeri
<?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";
}
Rezultat
[true,3,10,null] 1 [2,10,null] ValueError
Prva vrstica prikaže vrnjeno vrednost `true`, velikost `3`, ohranjeno vrednost `10` in novo mesto z vrednostjo `null`. Po zmanjšanju na `1` in ponovnem povečanju na `2` je na indeksu `1` vrednost `null`, ne prejšnja vrednost `20`. Zadnja vrstica se izpiše ob prestrezanju `ValueError`.
Povezane lekcije
- PHP · Lekcija 66 · Napredna · Različica: 2