Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

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

Zapíšte alebo nahraďte hodnotu v poli s pevnou veľkosťou. Porovnajte priame volanie s priradením pomocou hranatých zátvoriek a rozlíšte chyby indexu v PHP 8.3.

Verzia: PHP 8.3

Syntax

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

SplFixedArray::offsetSet zapisuje na existujúcu pozíciu objektu \SplFixedArray, triedy SPL v globálnom mennom priestore. SPL je súčasťou jadra PHP a v štandardných zostaveniach PHP 8.3 je vždy povolená. Pri platnom celočíselnom indexe zapisujú $array->offsetSet($index, $value) aj $array[$index] = $value na tú istú pozíciu. Hodnota môže byť ľubovoľného typu (mixed), vrátane null. Metóda mení objekt a nevracia žiadnu hodnotu (void).

Platný index spĺňa 0 <= $index && $index < $array->getSize(). Pri veľkosti 2 sa dá zapisovať na indexy 0 a 1, ale nie na index 2. Zápis nemení veľkosť a $array[] = $value nepridá prvok na koniec ako pri bežnom poli v PHP. Ak chcete pridať pozície, najprv zavolajte setSize() a potom zapíšte hodnotu na explicitne uvedený index.

V PHP 8.3 vyvolá celočíselný index mimo rozsahu výnimku RuntimeException, kým neplatný kľúč ako 'label' vyvolá TypeError. Od PHP 8.4 je konkrétnou triedou výnimky pri indexe mimo rozsahu OutOfBoundsException, podtrieda RuntimeException. Ak index pochádza z externého vstupu, overte is_int($index) a rozsah namiesto spoliehania sa na implicitný prevod.

Prí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ýsledok

draft
ready
RuntimeException
TypeError

Skript pomocou metódy uloží `draft` na index 1 a potom hodnotu pomocou hranatých zátvoriek prepíše na `ready`. Nakoniec vypíše názvy tried výnimiek, najprv pre index 2 a potom pre kľúč `'label'`.

Súvisiace lekcie

  • PHP · Lekcia 66 · Pokročilá · Verzia: 2

Zdroje