[函数]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 接口来定义自定义排序规则。