Sequence 介面

(PECL ds >= 1.0.0)

簡介

Sequence 描述了在單一線性維度中排列的值的行為。某些語言將其稱為「List（列表）」。它類似於使用遞增整數鍵的陣列，但有一些例外：

值將始終被索引為 [0, 1, 2, …, size - 1]。
僅允許透過索引在 [0, size - 1] 範圍內存取值。

使用案例

任何您會將陣列用作列表的地方（不關心鍵）。
SplDoublyLinkedList 和 SplFixedArray 更有效率的替代方案。

介面概要

interface Ds\Sequence extends Ds\Collection, ArrayAccess {

/* 方法 */

抽象公開 allocate(整數 $capacity): 無

抽象公開 apply(可呼叫 $callback): 無

抽象公開 capacity(): 整數

抽象公開 contains(混合 ...$values): 布林

抽象公開 filter(可呼叫 $callback = ?): Ds\Sequence

抽象公開 find(混合 $value): 混合

抽象公開 first(): 混合

抽象公開 get(整數 $index): 混合

抽象公開 insert(整數 $index, 混合 ...$values): 無

抽象公開 join(字串 $glue = ?): 字串

抽象公開 last(): 混合

抽象公開 map(可呼叫 $callback): Ds\Sequence

抽象公開 merge(混合 $values): Ds\Sequence

抽象公開 pop(): 混合

抽象公開 push(混合 ...$values): 無

抽象公開 reduce(可呼叫 $callback, 混合 $initial = ?): 混合

抽象公開 remove(整數 $index): 混合

抽象公開 reverse(): 無

抽象公開 reversed(): Ds\Sequence

抽象公開 rotate(整數 $rotations): 無

抽象公開 set(整數 $index, 混合 $value): 無

抽象公開 shift(): 混合

抽象公開 slice(整數 $index, 整數 $length = ?): Ds\Sequence

抽象公開 sort(可呼叫 $comparator = ?): 無

抽象公開 sorted(可呼叫 $comparator = ?): Ds\Sequence

抽象公開 sum(): 整數|浮點數

抽象公開 unshift(混合 $values = ?): 無

/* 繼承的方法 */

公開 Ds\Collection::clear(): 無

公開 Ds\Collection::copy(): Ds\Collection

公開 Ds\Collection::isEmpty(): 布林值

公開 Ds\Collection::toArray(): 陣列

公開 Countable::count(): 整數

公開 IteratorAggregate::getIterator(): Traversable

公開 JsonSerializable::jsonSerialize(): 混合

公開 ArrayAccess::offsetExists(混合 $offset): 布林值

公開 ArrayAccess::offsetGet(混合 $offset): 混合

公開 ArrayAccess::offsetSet(混合 $offset, 混合 $value): 無

公開 ArrayAccess::offsetUnset(混合 $offset): 無

}

更新日誌

版本	說明
PECL ds 1.3.0	此介面現在繼承自 ArrayAccess。

Ds\Sequence::allocate — 配置足夠的記憶體以滿足所需的容量
Ds\Sequence::apply — 透過將回呼函式應用於每個值來更新所有值
Ds\Sequence::capacity — 傳回目前的容量
Ds\Sequence::contains — 判斷序列是否包含給定的值
Ds\Sequence::filter — 使用可呼叫物件來決定要包含哪些值，以建立新的序列
Ds\Sequence::find — 嘗試尋找值的索引
Ds\Sequence::first — 傳回序列中的第一個值
Ds\Sequence::get — 傳回給定索引處的值
Ds\Sequence::insert — 在給定索引處插入值
Ds\Sequence::join — 將所有值連接成一個字串
Ds\Sequence::last — 傳回最後一個值
Ds\Sequence::map — 傳回將回呼應用於每個值的結果
Ds\Sequence::merge — 傳回將所有給定值新增到序列的結果
Ds\Sequence::pop — 移除並傳回最後一個值
Ds\Sequence::push — 將值新增到序列的末尾
Ds\Sequence::reduce — 使用回呼函式將序列縮減為單個值
Ds\Sequence::remove — 透過索引移除並傳回一個值
Ds\Sequence::reverse — 就地反轉序列
Ds\Sequence::reversed — 傳回反轉的副本
Ds\Sequence::rotate — 旋轉序列指定次數
Ds\Sequence::set — 更新指定索引的值
Ds\Sequence::shift — 移除並返回第一個值
Ds\Sequence::slice — 返回指定範圍的子序列
Ds\Sequence::sort — 就地排序序列
Ds\Sequence::sorted — 返回排序後的副本
Ds\Sequence::sum — 返回序列中所有值的總和
Ds\Sequence::unshift — 在序列前面添加值

發現問題了嗎？

了解如何改進此頁面 • 提交拉取請求 • 回報錯誤

＋新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。

Sequence 介面

簡介

介面概要

更新日誌

目錄

發現問題了嗎？

使用者貢獻的註釋