Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti