PHP 8.4.0 RC4 available for testing

Класс Vector

(PECL ds >= 1.0.0)

Введение

Вектор — последовательность значений в непрерывном буфере, который растёт и обрезается автоматически. Это наиболее эффективная последовательная структура, поскольку индекс значения прямо сопоставляются с индексом в буфере, и фактор роста не влияет на сложность доступа.

Сильные стороны

  • Поддерживает синтаксис массива (квадратные скобки).
  • Использует меньше памяти, чем массив (array) с тем же количеством элементов.
  • Автоматически высвобождает память, когда количество элементов уменьшается.
  • Вместимость не ограничена степенями двойки.
  • Сложность методов get(), set(), push() и pop() составляет O(1).

Слабые стороны

  • Сложность методов shift(), unshift(), insert() и remove() составляет O(n).

Обзор класса

class Ds\Vector implements Ds\Sequence, ArrayAccess {
/* Константы */
const int MIN_CAPACITY = 10;
/* Методы */
public allocate(int $capacity): void
public apply(callable $callback): void
public capacity(): int
public clear(): void
public contains(mixed ...$values): bool
public copy(): Ds\Vector
public filter(callable $callback = ?): Ds\Vector
public find(mixed $value): mixed
public first(): mixed
public get(int $index): mixed
public insert(int $index, mixed ...$values): void
public isEmpty(): bool
public join(string $glue = ?): string
public last(): mixed
public map(callable $callback): Ds\Vector
public merge(mixed $values): Ds\Vector
public pop(): mixed
public push(mixed ...$values): void
public reduce(callable $callback, mixed $initial = ?): mixed
public remove(int $index): mixed
public reverse(): void
public rotate(int $rotations): void
public set(int $index, mixed $value): void
public shift(): mixed
public slice(int $index, int $length = ?): Ds\Vector
public sort(callable $comparator = ?): void
public sorted(callable $comparator = ?): Ds\Vector
public sum(): int|float
public toArray(): array
public unshift(mixed $values = ?): void
}

Предопределённые константы

Ds\Vector::MIN_CAPACITY

Список изменений

Версия Описание
PECL ds 1.3.0 Теперь класс реализует интерфейс ArrayAccess.

Содержание

  • Ds\Vector::allocate — Выделяет память под указанную вместимость
  • Ds\Vector::apply — Обновляет все значения, применяя к ним переданную callback-функцию
  • Ds\Vector::capacity — Возвращает текущую вместимость
  • Ds\Vector::clear — Удаляет все значения
  • Ds\Vector::__construct — Создаёт новый экземпляр
  • Ds\Vector::contains — Проверяет, содержится ли в векторе заданные значения
  • Ds\Vector::copy — Возвращает поверхностную копию вектора
  • Ds\Vector::count — Возвращает количество элементов вектора
  • Ds\Vector::filter — Создаёт новый вектор из элементов, выбранных с помощью заданной callback-функции
  • Ds\Vector::find — Поиск индекса по значению
  • Ds\Vector::first — Возвращает первый элемент вектора
  • Ds\Vector::get — Возвращает значение по индексу
  • Ds\Vector::insert — Вставляет значения по указанному индексу
  • Ds\Vector::isEmpty — Проверяет, пуст ли вектор
  • Ds\Vector::join — Склеивает все значения в строку
  • Ds\Vector::jsonSerialize — Возвращает вектор в JSON-представлении
  • Ds\Vector::last — Возвращает последнее значение вектора
  • Ds\Vector::map — Возвращает результат применения callback-функции ко всем значениям вектора
  • Ds\Vector::merge — Возвращает результат добавления всех заданных значений в вектор
  • Ds\Vector::pop — Удаляет и возвращает последнее значение
  • Ds\Vector::push — Добавляет значения в конец вектора
  • Ds\Vector::reduce — Уменьшает вектор до одного значения, используя callback-функцию
  • Ds\Vector::remove — Удаляет и возвращает значение по индексу
  • Ds\Vector::reverse — Переворачивает текущий вектор
  • Ds\Vector::reversed — Возвращает перевёрнутую копию вектора
  • Ds\Vector::rotate — Перематывает вектор на заданное число значений
  • Ds\Vector::set — Заменяет значение по указанному индексу
  • Ds\Vector::shift — Удаляет и возвращает первое значение
  • Ds\Vector::slice — Возвращает подвектор из заданного диапазона
  • Ds\Vector::sort — Сортирует вектор
  • Ds\Vector::sorted — Возвращает отсортированную по значению копию коллекции
  • Ds\Vector::sum — Возвращает сумму всех значений коллекции
  • Ds\Vector::toArray — Преобразовывает коллекцию в массив (array)
  • Ds\Vector::unshift — Добавляет значения в начало вектора
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top