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

函式名稱：Ds\Sequence::shift()

函式描述：該方法從序列中移除並返回第一個元素。

適用版本：PHP 7.1.0 及以上版本。

用法：

$sequence = new \Ds\Vector([1, 2, 3]);

$value = $sequence->shift();
echo $value; // 輸出：1

print_r($sequence); // 輸出：Ds\Vector Object ([1, 2, 3])

示例解釋：

1. 首先，我們建立了一個 Ds\Vector 序列，並初始化了一些元素。
2. 然後我們呼叫 shift() 函式，將序列中的第一個元素彈出並賦值給 $value 變數。
3. 最後，我們輸出 $value 的值，可以看到它是序列中的第一個元素 1。
4. 我們還使用了 print_r() 函式來檢視序列中剩餘的元素，可以看到元素 1 已被移除，序列變為 [2, 3]。

注意事項：

• 如果序列為空，呼叫 shift() 方法將引發 UnderflowException 異常。
• shift() 方法會修改原始序列，將其改為移除第一個元素後的新序列。