[函数]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() 函数只移除指定的键或索引对应的第一个元素，如果序列中包含多个相同的键或索引，只会移除第一个遇到的。
• 如果指定的键或索引不存在，此函数不会引发错误或异常。