The D Programming Language's Unofficial Docs
beta
The D Programming Language's Unofficial Docs
beta
The transformation to apply. Either a unary function (unaryFun!transform(element)), or a binary function (binaryFun!transform(element, index)).
The predicate to sort the transformed elements by.
The swapping strategy to use.
The range to sort.
The initial range wrapped as a SortedRange with the predicate (a, b) => binaryFun!less(transform(a), transform(b)).
uint hashFun(string) { ... expensive computation ... } string[] array = ...; // Sort strings by hash, slow sort!((a, b) => hashFun(a) < hashFun(b))(array); // Sort strings by hash, fast (only computes arr.length hashes): schwartzSort!(hashFun, "a < b")(array);
The schwartzSort function might require less temporary data and be faster than the Perl idiom or the decorate-sort-undecorate idiom present in Python and Lisp. This is because sorting is done in-place and only minimal extra data (one array of transformed elements) is created.
To check whether an array was sorted and benefit of the speedup of Schwartz sorting, a function schwartzIsSorted is not provided because the effect can be achieved by calling isSorted!less(map!transform(r)).
1 import std.algorithm.iteration : map; 2 import std.numeric : entropy; 3 4 auto lowEnt = [ 1.0, 0, 0 ], 5 midEnt = [ 0.1, 0.1, 0.8 ], 6 highEnt = [ 0.31, 0.29, 0.4 ]; 7 auto arr = new double[][3]; 8 arr[0] = midEnt; 9 arr[1] = lowEnt; 10 arr[2] = highEnt; 11 12 schwartzSort!(entropy, "a > b")(arr); 13 14 assert(arr[0] == highEnt); 15 assert(arr[1] == midEnt); 16 assert(arr[2] == lowEnt); 17 assert(isSorted!("a > b")(map!(entropy)(arr)));
Alternative sorting method that should be used when comparing keys involves an expensive computation. Instead of using less(a, b) for comparing elements, schwartzSort uses less(transform(a), transform(b)). The values of the transform function are precomputed in a temporary array, thus saving on repeatedly computing it. Conversely, if the cost of transform is small compared to the cost of allocating and filling the precomputed array, sort may be faster and therefore preferable.
This approach to sorting is akin to the Schwartzian transform, also known as the decorate-sort-undecorate pattern in Python and Lisp. The complexity is the same as that of the corresponding sort, but schwartzSort evaluates transform only r.length times (less than half when compared to regular sorting). The usage can be best illustrated with an example.