La clase SplFixedArray

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    Introducción

    la clase SplFixedArray proporciona la funcionalidad principal de un array. La principal diferencia entre SplFixedArray y un array normal de PHP es que la clase SplFixedArray es de longitud fija y sólo permite enteros dentro del rango de índices. La ventaja es que usa menos memoría que un array estándar.

    Sinopsis de la Clase

    classSplFixedArrayimplementsIteratorAggregate, ArrayAccess, Countable, JsonSerializable {
    public__construct(int$size = 0)
    publiccount(): int
    publiccurrent(): mixed
    publicstaticfromArray(array$array, bool$preserveKeys = true): SplFixedArray
    publicgetIterator(): Iterator
    publicgetSize(): int
    publicjsonSerialize(): array
    publickey(): int
    publicnext(): void
    publicoffsetExists(int$index): bool
    publicoffsetGet(int$index): mixed
    publicoffsetSet(int$index, mixed$value): void
    publicoffsetUnset(int$index): void
    publicrewind(): void
    public__serialize(): array
    publicsetSize(int$size): bool
    publictoArray(): array
    public__unserialize(array$data): void
    publicvalid(): bool
    public__wakeup(): void
    }

    Historial de cambios

    VersiónDescripción
    8.2.0 The SplFixedArray::__serialize() and SplFixedArray::__unserialize() magic methods have been added to SplFixedArray.
    8.1.0SplFixedArray implements JsonSerializable now.
    8.0.0SplFixedArray implements IteratorAggregate now. Previously, Iterator was implemented instead.

    Ejemplos

    Ejemplo #1 Ejemplo de uso SplFixedArray

    <?php
    // Inicializar el array con una longitud fija
    $array = new SplFixedArray(5);

    $array[1] = 2;
    $array[4] = "foo";

    var_dump($array[0]); // NULL
    var_dump($array[1]); // int(2)

    var_dump($array["4"]); // string(3) "foo"

    // Aumentar el tamaño del array a 10
    $array->setSize(10);

    $array[9] = "asdf";

    // Reducir el tamaño de un array a 2
    $array->setSize(2);

    // Las siguientes líneas lanzan una RuntimeException: Index invalid or out of range (Índice inválido o fuera de rango)
    try {
    var_dump($array["non-numeric"]);
    } catch(    RuntimeException $re) {
    echo     "RuntimeException: ".$re->getMessage()."\n";
    }

    try {
    var_dump($array[-1]);
    } catch(    RuntimeException $re) {
    echo     "RuntimeException: ".$re->getMessage()."\n";
    }

    try {
    var_dump($array[5]);
    } catch(    RuntimeException $re) {
    echo     "RuntimeException: ".$re->getMessage()."\n";
    }
    ?>

    El resultado del ejemplo sería:

     NULL int(2) string(3) "foo" RuntimeException: Index invalid or out of range RuntimeException: Index invalid or out of range RuntimeException: Index invalid or out of range

    Tabla de contenidos

    To Top