Rust slice.sort_unstable_by用法及代碼示例

用法

pub fn sort_unstable_by<F>(&mut self, compare: F) where    F: FnMut(&T, &T) -> Ordering,

使用比較器函數對切片進行排序，但可能不會保留相等元素的順序。

這種排序是不穩定的(即可能對相等的元素重新排序)、就地(即不分配)和 O(n * log(n)) 最壞情況。

比較器函數必須定義切片中元素的總排序。如果排序不是總的，則元素的順序是未指定的。如果訂單是總訂單(對於所有 a 、 b 和 c )：

• 完全和反對稱： a < b 、 a == b 或 a > b 中的一個為 true，並且
• 傳遞，a < b 和 b < c 暗示 a < c 。 == 和 > 都必須如此。

例如，雖然 f64 沒有實現 Ord 因為 NaN != NaN ，但當我們知道切片不包含 NaN 時，我們可以使用 partial_cmp 作為排序函數。

let mut floats = [5f64, 4.0, 1.0, 3.0, 2.0];
floats.sort_unstable_by(|a, b| a.partial_cmp(b).unwrap());
assert_eq!(floats, [1.0, 2.0, 3.0, 4.0, 5.0]);

當前實施

當前算法基於 Orson Peters 的pattern-defeating quicksort，它將隨機快速排序的快速平均情況與堆排序的快速最壞情況結合起來，同時在具有某些模式的切片上實現線性時間。它使用一些隨機化來避免退化情況，但使用固定種子始終提供確定性行為。

它通常比穩定排序快，除了在一些特殊情況下，例如，當切片由幾個連接的排序序列組成時。

例子

let mut v = [5, 4, 1, 3, 2];
v.sort_unstable_by(|a, b| a.cmp(b));
assert!(v == [1, 2, 3, 4, 5]);

// reverse sorting
v.sort_unstable_by(|a, b| b.cmp(a));
assert!(v == [5, 4, 3, 2, 1]);