La clase SplFixedArray

(PHP 5 >= 5.3.0)

Introducción

la clase SplFixedArray proporciona las principales funcionalidades de un array. las principales diferencias entre SplFixedArray y un array normal de PHP es que la clase SplFixedArray es de longitud fija y sólo permite integer dentro del rango de índices. La ventaja es que permite una implementación de array rápida.

Sinopsis de la Clase

SplFixedArray implements Iterator , ArrayAccess , Countable {

/* Métodos */

public __construct ([ int $size = 0 ] )

public int count ( void )

public mixed current ( void )

public static SplFixedArray fromArray ( array $array [, bool $save_indexes = true ] )

public int getSize ( void )

public int key ( void )

public void next ( void )

public bool offsetExists ( int $index )

public mixed offsetGet ( int $index )

public void offsetSet ( int $index , mixed $newval )

public void offsetUnset ( int $index )

public void rewind ( void )

public int setSize ( int $size )

public array toArray ( void )

public bool valid ( void )

public void __wakeup ( void )

}

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 al tamaño de 2
$array->setSize(2);

// Las siguientes líneas lanzan una RuntimeException: Index invalid or out of range
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

SplFixedArray::__construct — Construye un nuevo array fijo
SplFixedArray::count — Devuelve el tamaño del array
SplFixedArray::current — Devuelve la entrada del array actual
SplFixedArray::fromArray — Importa un array PHP en una instancia SplFixedArray
SplFixedArray::getSize — Obtiene el tamaño de el array
SplFixedArray::key — Devuelve los índices del array actual
SplFixedArray::next — Mover a la siguiente entrada
SplFixedArray::offsetExists — Devuelve si el índice solicitado existe
SplFixedArray::offsetGet — Devuelve el valor en el índice específicado
SplFixedArray::offsetSet — Establece un nuevo valor para el índice específicado
SplFixedArray::offsetUnset — Destruye el valor en el índice específicado
SplFixedArray::rewind — Rebobina el iterador hasta el inicio
SplFixedArray::setSize — Cambiar el tamaño de un array
SplFixedArray::toArray — Devuelve un array PHP de un array fijo
SplFixedArray::valid — Comprueba si el array contiene más elementos
SplFixedArray::__wakeup — Reinicializar el array después de ser deserializado