CKTIS / PHP
Promjena veličine SplFixedArray metodom SplFixedArray::setSize
Promijeni veličinu postojećeg polja `SplFixedArray`. Povećanje dodaje mjesta s vrijednošću `null`, a smanjenje uklanja vrijednosti s kraja polja.
Verzija: 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 mijenja veličinu postojećeg SPL objekta umjesto da stvara novi. To je metoda instance: pozovi je kao $array->setSize($size). Argument $size tipa int označava željeni broj mjesta, a ne broj mjesta koja treba dodati ni posljednji indeks. Pri pozitivnoj veličini indeksi idu od 0 do $size - 1.
Povećanje zadržava postojeće vrijednosti, a novim mjestima dodjeljuje null. Smanjenje zadržava vrijednosti na indeksima manjim od $size, a ostale odbacuje. Ponovno povećanje ne vraća odbačene vrijednosti. Veličina 0 uklanja sva mjesta. Ako veličina ostane ista, ni sadržaj se ne mijenja.
U PHP-u 8.3 privremeni je povratni tip bool, ali metoda pri normalnom završetku vraća true, a ne novu veličinu. Veličinu dohvati pomoću $array->getSize(). Od PHP-a 8.4 privremeni je povratni tip true. Negativna veličina izaziva ValueError. PHP_INT_MAX gornja je granica tipa int, a ne jamstvo da ima dovoljno memorije za toliko mjesta.
Primjeri
<?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
Prvi redak prikazuje povratnu vrijednost `true`, veličinu `3`, zadržanu vrijednost `10` i novo mjesto s vrijednošću `null`. Nakon smanjenja na `1` i ponovnog povećanja na `2`, na indeksu `1` nalazi se `null`, a ne prijašnja vrijednost `20`. Posljednji se redak ispisuje pri hvatanju `ValueError`.
Povezane lekcije
- PHP · Lekcija 66 · Napredno · Verzija: 2