CKTIS / PHP
SplFixedArray::offsetSet — Escribir un valor en un índice
Escribe o sustituye un valor en un array de tamaño fijo. Compara la llamada directa con la asignación mediante corchetes y distingue los errores de índice en PHP 8.3.
Versión: PHP 8.3
Sintaxis
$array->offsetSet($index, $value);
$array[$index] = $value;SplFixedArray::offsetSet escribe en una posición existente de un objeto \SplFixedArray, una clase de SPL que pertenece al espacio de nombres global. SPL forma parte del núcleo de PHP y está siempre habilitada en las compilaciones estándar de PHP 8.3. Con un índice entero válido, $array->offsetSet($index, $value) y $array[$index] = $value escriben en la misma posición. El valor puede ser de cualquier tipo (mixed), incluido null. El método modifica el objeto y no devuelve ningún valor (void).
Un índice válido cumple 0 <= $index && $index < $array->getSize(). Con un tamaño de 2 se puede escribir en los índices 0 y 1, pero no en el 2. Escribir no cambia el tamaño, y $array[] = $value no añade un elemento al final como en un array normal de PHP. Para añadir posiciones, llama primero a setSize() y luego escribe en un índice explícito.
En PHP 8.3, un índice entero fuera de rango provoca RuntimeException, mientras que una clave no válida como 'label' provoca TypeError. A partir de PHP 8.4, la clase de excepción concreta para un índice fuera de rango es OutOfBoundsException, una subclase de RuntimeException. Si el índice viene de una entrada externa, comprueba is_int($index) y el rango en vez de confiar en la conversión implícita.
Ejemplos
<?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";
}
Resultado
draft ready RuntimeException TypeError
El script guarda `draft` en el índice 1 mediante el método y luego lo sustituye por `ready` mediante una asignación con corchetes. Por último, imprime los nombres de las clases de excepción correspondientes al índice 2 y a la clave `'label'`, respectivamente.
Lecciones relacionadas
- PHP · Lección 66 · Avanzado · Versión: 2