CKTIS / PHP
SplFixedArray::offsetGet — leggere un elemento per indice
Leggi una posizione con `offsetGet()` o `[]` e distingui un valore `null` da un indice fuori intervallo o da un tipo di indice non supportato.
Versione: PHP 8.3
Sintassi
$value = $array->offsetGet($index);
$value = $array[$index];SplFixedArray::offsetGet è un metodo di istanza che restituisce il valore all’indice richiesto. Il tipo restituito è mixed: il valore mantiene il tipo con cui è stato memorizzato. Grazie ad ArrayAccess, una normale lettura con $array[$index] dà lo stesso risultato di $array->offsetGet($index). La classe fa parte di SPL, che è integrata in PHP 8.3 e non può essere disattivata. In un namespace con nome, usa \SplFixedArray oppure importa SplFixedArray.
Gli indici partono da zero e devono soddisfare 0 <= $index && $index < $array->getSize(). Leggere una posizione valida a cui non è mai stato assegnato un valore restituisce null. Leggere un null memorizzato esplicitamente dà lo stesso risultato. Il solo valore restituito non permette di distinguere i due casi.
In PHP 8.3, un indice intero fuori intervallo genera RuntimeException; un tipo di indice non supportato, come quello della stringa 'name', genera TypeError. A partire da PHP 8.4, l’errore di intervallo è OutOfBoundsException, una sottoclasse di RuntimeException. Prima di PHP 8.1, le chiavi non supportate generavano RuntimeException. Verifica il tipo e l’intervallo degli indici provenienti da input esterni, senza contare sulla conversione implicita: per esempio, una lettura con [] può trattare la stringa '0' come l’indice 0.
Il metodo non restituisce un riferimento alla posizione. Per modificare un array PHP annidato, leggilo in una variabile, modificalo e riscrivilo con $array[$index] = $value o $array->offsetSet($index, $value).
Esempi
<?php
$array = new \SplFixedArray(2);
$array[0] = 42;
var_dump($array->offsetGet(0));
var_dump($array[0]);
var_dump($array->offsetGet(1));
foreach ([2, 'name'] as $index) {
try {
$array->offsetGet($index);
} catch (\RuntimeException | \TypeError $error) {
echo get_class($error), "\n";
}
}
Risultato
int(42) int(42) NULL RuntimeException TypeError
Entrambe le forme di lettura restituiscono `int(42)`. La posizione senza un valore assegnato restituisce `NULL`; le ultime due righe mostrano le classi delle eccezioni attese in PHP 8.3.
Lezioni correlate
- PHP · Lezione 66 · Avanzato · Versione: 2