CKTIS / PHP
De grootte van een SplFixedArray wijzigen met SplFixedArray::setSize
Pas de grootte van een bestaande `SplFixedArray` aan. Vergroten voegt posities met `null` toe; verkleinen verwijdert waarden aan het einde.
Versie: 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 wijzigt de grootte van een bestaand SPL-object zonder een nieuw object aan te maken. Het is een instantiemethode: roep haar aan met $array->setSize($size). Het argument $size van het type int is het gewenste aantal posities, niet het aantal dat erbij moet of de laatste index. Bij een positieve grootte lopen de indexen van 0 tot en met $size - 1.
Bij vergroten blijven de bestaande waarden behouden en krijgen de nieuwe posities de waarde null. Bij verkleinen blijven waarden op indexen kleiner dan $size behouden en verdwijnen de overige waarden. Opnieuw vergroten haalt die waarden niet terug. De grootte 0 verwijdert alle posities. Als de grootte gelijk blijft, verandert de inhoud niet.
In PHP 8.3 is bool het voorlopige retourtype, maar bij normale afronding geeft de methode true terug, niet de nieuwe grootte. Lees de grootte uit met $array->getSize(). Sinds PHP 8.4 is het voorlopige retourtype true. Een negatieve grootte veroorzaakt een ValueError. PHP_INT_MAX is de bovengrens van int, geen garantie dat er genoeg geheugen is voor zoveel posities.
Voorbeelden
<?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";
}
Resultaat
[true,3,10,null] 1 [2,10,null] ValueError
De eerste regel toont de retourwaarde `true`, de grootte `3`, de behouden waarde `10` en een nieuwe positie met `null`. Na verkleinen tot `1` en opnieuw vergroten tot `2` staat op index `1` de waarde `null`, niet de oude waarde `20`. De laatste regel verschijnt wanneer `ValueError` wordt afgevangen.
Gerelateerde lessen
- PHP · Les 66 · Gevorderd · Versie: 2