Класс SplFixedArray

(PHP 5 >= 5.3.0, PHP 7)

Введение

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

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

SplFixedArray implements Iterator , ArrayAccess , Countable {

/* Методы */

public __construct ( int $size = 0 )

public count ( ) : int

public current ( ) : mixed

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

public getSize ( ) : int

public key ( ) : int

public next ( ) : void

public offsetExists ( int $index ) : bool

public offsetGet ( int $index ) : mixed

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

public offsetUnset ( int $index ) : void

public rewind ( ) : void

public setSize ( int $size ) : bool

public toArray ( ) : array

public valid ( ) : bool

public __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 — Переинициализация массива после десериализации