CKTIS / PHP
SplFixedArray::offsetSet — Upis vrijednosti na indeks
Upiši ili zamijeni vrijednost u polju fiksne veličine. Usporedi izravni poziv s dodjelom pomoću uglatih zagrada i razlikuj pogreške pri indeksiranju u PHP-u 8.3.
Verzija: PHP 8.3
Sintaksa
$array->offsetSet($index, $value);
$array[$index] = $value;SplFixedArray::offsetSet upisuje vrijednost na postojeće mjesto u objektu \SplFixedArray, klasi SPL-a u globalnom imenskom prostoru. SPL je dio jezgre PHP-a i uvijek je omogućen u standardnim međuverzijama PHP-a 8.3. Uz valjani cjelobrojni indeks, $array->offsetSet($index, $value) i $array[$index] = $value upisuju na isto mjesto. Vrijednost može biti bilo kojeg tipa (mixed), uključujući null. Metoda mijenja objekt i ne vraća vrijednost (void).
Valjani indeks ispunjava uvjet 0 <= $index && $index < $array->getSize(). Ako je veličina 2, možeš upisivati na indekse 0 i 1, ali ne i na indeks 2. Upis ne mijenja veličinu, a $array[] = $value ne dodaje element na kraj kao kod običnog PHP polja. Za dodavanje mjesta prvo pozovi setSize(), a zatim upiši vrijednost na izričito navedeni indeks.
U PHP-u 8.3 cjelobrojni indeks izvan raspona izaziva RuntimeException, dok nevaljani ključ poput 'label' izaziva TypeError. Od PHP-a 8.4 konkretna klasa iznimke za indeks izvan raspona jest OutOfBoundsException, podklasa klase RuntimeException. Ako indeks dolazi iz vanjskog unosa, provjeri is_int($index) i raspon umjesto da se oslanjaš na implicitnu pretvorbu.
Primjeri
<?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
Skripta metodom sprema `draft` na indeks 1, a zatim tu vrijednost dodjelom pomoću uglatih zagrada zamjenjuje vrijednošću `ready`. Na kraju ispisuje nazive klasa iznimki, prvo za indeks 2, a zatim za ključ `'label'`.
Povezane lekcije
- PHP · Lekcija 66 · Napredno · Verzija: 2