Ds\Sequence::remove()函式—用法及示例

函式名：Ds\Sequence::remove()

函式描述：此函式用於根據指定的鍵或索引從序列中移除一個元素。

用法：

public function remove($key): void

引數說明：

• $key: 要移除的元素的鍵或索引。

返回值：無返回值。

示例：

$sequence = new \Ds\Vector([1, 2, 3, 4, 5]);
$sequence->remove(2); // 移除索引為2的元素
print_r($sequence); // 輸出: Ds\Vector Object ([0] => 1 [1] => 2 [3] => 4 [4] => 5)

$sequence = new \Ds\Deque(['a' => 1, 'b' => 2, 'c' => 3]);
$sequence->remove('b'); // 移除鍵為'b'的元素
print_r($sequence); // 輸出: Ds\Deque Object ([a] => 1 [c] => 3)

注意：

• Ds\Sequence 是一個抽象類，通常使用其具體子類進行例項化，如 Ds\Vector、Ds\Deque 等。
• remove() 函式只移除指定的鍵或索引對應的第一個元素，如果序列中包含多個相同的鍵或索引，只會移除第一個遇到的。
• 如果指定的鍵或索引不存在，此函式不會引發錯誤或異常。