CKTIS / PHP
Die Größe eines SplFixedArray mit SplFixedArray::setSize ändern
Ändere die Größe eines vorhandenen `SplFixedArray`. Beim Vergrößern entstehen neue Plätze mit `null`; beim Verkleinern entfallen Werte am Ende.
Version: 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 ändert die Größe eines vorhandenen SPL-Objekts, statt ein neues zu erzeugen. Rufe die Instanzmethode mit $array->setSize($size) auf. Das int-Argument $size gibt die gewünschte Anzahl der Plätze an, nicht den Zuwachs oder den letzten Index. Bei positiver Größe reichen die Indizes von 0 bis $size - 1.
Beim Vergrößern bleiben vorhandene Werte erhalten, und die neuen Plätze enthalten null. Beim Verkleinern bleiben Werte an Indizes unterhalb von $size erhalten; die übrigen werden verworfen. Erneutes Vergrößern stellt diese Werte nicht wieder her. Die Größe 0 entfernt alle Plätze. Bei unveränderter Größe bleibt der Inhalt gleich.
In PHP 8.3 ist bool der vorläufige Rückgabetyp. Bei normalem Abschluss liefert die Methode true, nicht die neue Größe. Lies die Größe mit $array->getSize() aus. Seit PHP 8.4 ist true der vorläufige Rückgabetyp. Eine negative Größe löst einen ValueError aus. PHP_INT_MAX ist die Obergrenze für int, garantiert aber nicht genug Speicher für so viele Plätze.
Beispiele
<?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";
}
Ergebnis
[true,3,10,null] 1 [2,10,null] ValueError
Die erste Zeile zeigt den Rückgabewert `true`, die Größe `3`, den erhaltenen Wert `10` und einen neuen Platz mit `null`. Nach dem Verkleinern auf `1` und dem erneuten Vergrößern auf `2` steht an Index `1` nun `null` statt des früheren Werts `20`. Die letzte Zeile stammt vom Abfangen des `ValueError`.
Zugehörige Lektionen
- PHP · Lektion 66 · Fortgeschritten · Version: 2