Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

SplFixedArray::offsetSet — Scrivere un valore a un indice

Scrivi o sostituisci un valore in un array di dimensione fissa. Confronta la chiamata diretta con l’assegnazione tramite parentesi quadre e distingui gli errori di indice in PHP 8.3.

Versione: PHP 8.3

Sintassi

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

SplFixedArray::offsetSet scrive in una posizione esistente di un oggetto \SplFixedArray, una classe di SPL nello spazio dei nomi globale. SPL fa parte del core di PHP ed è sempre abilitata nelle build standard di PHP 8.3. Con un indice intero valido, $array->offsetSet($index, $value) e $array[$index] = $value scrivono nella stessa posizione. Il valore può essere di qualsiasi tipo (mixed), incluso null. Il metodo modifica l’oggetto e non restituisce alcun valore (void).

Un indice valido soddisfa 0 <= $index && $index < $array->getSize(). Con una dimensione di 2 si può scrivere agli indici 0 e 1, ma non al 2. La scrittura non cambia la dimensione e $array[] = $value non aggiunge un elemento in coda come accade con un normale array PHP. Per aggiungere posizioni, chiama prima setSize(), poi scrivi a un indice esplicito.

In PHP 8.3, un indice intero fuori dai limiti genera RuntimeException, mentre una chiave non valida come 'label' genera TypeError. Da PHP 8.4, la classe di eccezione specifica per un indice fuori dai limiti è OutOfBoundsException, una sottoclasse di RuntimeException. Se l’indice proviene da un input esterno, controlla is_int($index) e i limiti invece di affidarti alla conversione implicita.

Esempi

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

Risultato

draft
ready
RuntimeException
TypeError

Lo script usa il metodo per memorizzare `draft` all’indice 1, poi lo sostituisce con `ready` mediante un’assegnazione con parentesi quadre. Infine stampa i nomi delle classi di eccezione per l’indice 2 e la chiave `'label'`, rispettivamente.

Lezioni correlate

  • PHP · Lezione 66 · Avanzato · Versione: 2

Fonti