Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

SplFixedArray::offsetSet — Zápis hodnoty na daný index

Zapište nebo nahraďte hodnotu v poli s pevnou velikostí. Porovnejte přímé volání s přiřazením pomocí hranatých závorek a rozlište chyby indexu v PHP 8.3.

Verze: PHP 8.3

Syntaxe

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

SplFixedArray::offsetSet zapisuje do existující pozice objektu \SplFixedArray, třídy SPL v globálním jmenném prostoru. SPL je součástí jádra PHP a ve standardních sestaveních PHP 8.3 je vždy povolena. Pro platný celočíselný index zapisují $array->offsetSet($index, $value) i $array[$index] = $value na stejnou pozici. Hodnota může být libovolného typu (mixed), včetně null. Metoda mění objekt a nevrací žádnou hodnotu (void).

Platný index splňuje 0 <= $index && $index < $array->getSize(). Při velikosti 2 lze zapisovat na indexy 0 a 1, ale ne na index 2. Zápis nemění velikost a $array[] = $value nepřidá prvek na konec jako u běžného pole v PHP. Chcete-li přidat pozice, nejprve zavolejte setSize() a potom zapište na explicitně uvedený index.

V PHP 8.3 vyvolá celočíselný index mimo rozsah výjimku RuntimeException, zatímco neplatný klíč jako 'label' vyvolá TypeError. Od PHP 8.4 je konkrétní třídou výjimky pro index mimo rozsah OutOfBoundsException, podtřída RuntimeException. Pokud index pochází z externího vstupu, ověřte is_int($index) a rozsah místo spoléhání na implicitní převod.

Příklady

<?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";
}

Výsledek

draft
ready
RuntimeException
TypeError

Skript metodou uloží `draft` na index 1 a pak hodnotu pomocí hranatých závorek přepíše na `ready`. Nakonec vypíše názvy tříd výjimek, nejprve pro index 2 a poté pro klíč `'label'`.

Související lekce

  • PHP · Lekce 66 · Pokročilá · Verze: 2

Zdroje