Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / PHP

SplFixedArray::offsetSet — Zapis vrednosti na indeks

Zapiši ali zamenjaj vrednost v polju s fiksno velikostjo. Primerjaj neposredni klic s prirejanjem z oglatimi oklepaji in razlikuj med napakami pri indeksiranju v PHP 8.3.

Različica: PHP 8.3

Sintaksa

$array->offsetSet($index, $value);
$array[$index] = $value;

SplFixedArray::offsetSet zapiše vrednost na obstoječe mesto v objektu \SplFixedArray, razredu SPL v globalnem imenskem prostoru. SPL je del jedra PHP in je v standardnih gradnjah PHP 8.3 vedno omogočena. Pri veljavnem celoštevilskem indeksu $array->offsetSet($index, $value) in $array[$index] = $value zapišeta vrednost na isto mesto. Vrednost je lahko katerega koli tipa (mixed), tudi null. Metoda spremeni objekt in ne vrne vrednosti (void).

Veljaven indeks izpolnjuje pogoj 0 <= $index && $index < $array->getSize(). Pri velikosti 2 lahko pišeš na indeksa 0 in 1, ne pa na indeks 2. Zapis ne spremeni velikosti, $array[] = $value pa ne doda elementa na konec kot pri običajnem polju PHP. Če želiš dodati mesta, najprej pokliči setSize() in nato zapiši vrednost na izrecno podan indeks.

V PHP 8.3 celoštevilski indeks zunaj dovoljenega obsega sproži RuntimeException, neveljaven ključ, kot je 'label', pa TypeError. Od PHP 8.4 je razred izjeme za indeks zunaj dovoljenega obsega OutOfBoundsException, podrazred RuntimeException. Če indeks prihaja iz zunanjega vnosa, preveri is_int($index) in dovoljeni obseg, namesto da se zanašaš na samodejno pretvorbo.

Primeri

<?php
$array = new \SplFixedArray(2);

$array->offsetSet(1, 'draft');
echo $array[1], "\n";

$array[1] = 'ready';
echo $array[1], "\n";

try {
    $array->offsetSet(2, 'extra');
} catch (\RuntimeException $error) {
    echo get_class($error), "\n";
}

try {
    $array['label'] = 'extra';
} catch (\TypeError $error) {
    echo get_class($error), "\n";
}

Rezultat

draft
ready
RuntimeException
TypeError

Skript z metodo shrani `draft` na indeks 1, nato pa vrednost s prirejanjem z oglatimi oklepaji zamenja z `ready`. Na koncu izpiše imeni razredov izjem, najprej za indeks 2 in nato za ključ `'label'`.

Povezane lekcije

  • PHP · Lekcija 66 · Napredna · Različica: 2

Viri