Класс SplFixedArray обеспечивает базовую функциональность, предоставляемый массивами. Главное различие между SplFixedArray и обычным массивом PHP в том, что SplFixedArray имеет фиксированную длину, а в качестве индексов могут выступать только целочисленные значения. Преимущество данных ограничений заключается в более быстрой обработке массива.

Обзор классов

SplFixedArray implements Iterator , ArrayAccess , Countable {

/* Методы */

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 )

}

Примеры

Пример #1 Пример использования SplFixedArray


<?php
// Инициализация массива фиксированной длиной
$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"

// Увеличение размера массива до 10
$array->setSize(10);

$array[9] = "asdf";

// Сокращаем размер массива до 2-х
$array->setSize(2);

// Следующий код вызывает исключение 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";
}
?>

Результат выполнения данного примера:

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

Содержание

SplFixedArray::__construct — Создает новый массив фиксированной длины
SplFixedArray::count — Возвращает размер массива
SplFixedArray::current — Возвращает текущий элемент массива
SplFixedArray::fromArray — Импортирует PHP-массив в объект класса SplFixedArray
SplFixedArray::getSize — Получает размер массива
SplFixedArray::key — Возвращает индекс текущего элемента массива
SplFixedArray::next — Переходит к следующему элементу массива
SplFixedArray::offsetExists — Возвращает факт наличия указанного индекса массива
SplFixedArray::offsetGet — Возвращает значение по указанному индексу
SplFixedArray::offsetSet — Устанавливает новое значение по заданному индексу
SplFixedArray::offsetUnset — Удаляет значение по индексу $index
SplFixedArray::rewind — Выставляет итератор массива в начало
SplFixedArray::setSize — Изменяет размер массива
SplFixedArray::toArray — Возвращает обычный PHP-массив со значениями фиксированного массива
SplFixedArray::valid — Проверяет массив на наличие элементов
SplFixedArray::__wakeup — Reinitialises the array after being unserialised

Вернуться к: Структуры данных