Ds\Deque::sorted()函式—用法及示例

函式名稱：Ds\Deque::sorted()

適用版本：Ds extension 1.3.0 或更高版本

用法：Ds\Deque::sorted() 函式用於返回一個已排序的Deque副本（Deque是PHP中的一種雙端佇列資料結構）。

示例：

// 建立一個新的Deque例項並新增元素
$deque = new Ds\Deque([3, 2, 5, 1, 4]);

// 使用sorted()函式獲取已排序的副本
$sortedDeque = $deque->sorted();

// 輸出原始Deque
echo "原始Deque: ";
foreach ($deque as $item) {
    echo $item . " ";
}
echo PHP_EOL;

// 輸出排序後的Deque
echo "排序後的Deque: ";
foreach ($sortedDeque as $item) {
    echo $item . " ";
}
echo PHP_EOL;

輸出結果：

原始Deque: 3 2 5 1 4
排序後的Deque: 1 2 3 4 5

注意：Ds\Deque::sorted() 函式會返回一個新的排序後的Deque物件，原始Deque物件將保持不變。該函式預設使用 < 運算子進行排序，對於自定義物件型別，可以實現 Comparable 介面來定義自定義排序規則。