# Shufflin’ Ain’t Sortin’

I recently added a test-shuffling feature to the Fixie test framework. The basic idea is that you can opt into randomizing the order of execution for tests within a test class. I’ll cover the details of the test shuffling feature in my next post. Today, let’s take a deeper look at shuffling in general. Readily-available advice on shuffling is actually quite wrong.

## The Too-Clever One-Liner

Let’s say you want to randomize the order of items in a simple .NET array. A little googling will lead you to solutions like this:

``````Random rnd=new Random();
string[] shuffled = array.OrderBy(x => rnd.Next()).ToArray();``````

You may have also run into similar shufflers that use Guid.NewGuid() for the same effect. This seems pretty reasonable. We’re “randomingly sorting” the items. Each time the sort algorithm needs to decide the order of two items, it’ll basically flip a coin. go What could wrong possibly?

I’m sure I’ve followed this advice on past projects, and never ran into any trouble. It might actually work, but if so it works only due to a convenient accident of implementation details.

Sorting algorithms operate with a very specific contract in mind. They frequently need to compare two items, and you are expected to provide a consistent answer to the question, “Which comes first, a or b?”. (In the case of OrderBy, the lambda provides a “key selector” for shorthand: a comes before b if a’s ‘key’ comes before b’s ‘key’. The overall contract of consistent ordering is still present.)

Consider a humble Bubble Sort:

``````//Jon Skeet's Bubble Sort from http://stackoverflow.com/a/1595310
public void BubbleSort<T>(IList<T> list, IComparer<T> comparer)
{
bool stillGoing = true;
while (stillGoing)
{
stillGoing = false;
for (int i = 0; i < list.Length-1; i++)
{
T x = list[i];
T y = list[i + 1];
if (comparer.Compare(x, y) > 0)
{
list[i] = y;
list[i + 1] = x;
stillGoing = true;
}
}
}
}``````

Imagine our comparer flips a coin each time it is asked to compare two items in the array. That while loop starts to look pretty scary. Each iteration of the outer loop makes a single pass through the list. If any items get swapped during that pass, we are `stillGoing` and will execute another pass through the list. When would the bubble sort even terminate? It’ll terminate when we happen to generate `list.Length` consistent answers in a row. A few test runs of this loop against a 10-item array reached thousands of iterations before terminating!

Sure, .NET’s array sorter doesn’t use Bubble Sort, but the clever one-liner may fall into the same basic trap. In practice it seems to work, but just try proving that it will always work. What algorithm does .NET’s `Array.Sort(...)` use? Insertion Sort? Heap Sort? Quick Sort? Trick question: it could do any of those depending on the input array. You could inspect the implementation all day long, constructing an ironclad proof that a randomized comparer will in fact work in all possible cases, and still run into trouble when a future implementation changes the underlying algorithm(s).

Randomized sorting is a contradiction in terms.

## Real Shuffling

Thankfully, real shuffling is a solved problem. We don’t have to violate an algorithm’s contract if we use the right algorithm.

``````//Matt Howells's Shuffler from http://stackoverflow.com/a/110570
public static void Shuffle<T>(this T[] array, Random random)
{
int n = array.Length;
while (n > 1)
{
int k = random.Next(n--);
T temp = array[n];
array[n] = array[k];
array[k] = temp;
}
}``````

Most of the world’s loops have already been written, and they have names. This is the Fisher-Yates Shuffle. It randomizes the order of array items in a single pass.

We’ve adopted the term “contract” for a reason: two parties make an agreement about how they are meant to interact. Violate the contract, and who knows what will happen.

#### Related Articles:

Post Footer automatically generated by Add Post Footer Plugin for wordpress.

I am a Senior Consultant at Headspring in Austin, TX. I created the Parsley text parsing library and the Fixie test framework.
• http://tech.trailmax.info/ trailmax

That’s pretty interesting problem you run into. Quick google uncovered a few solutions and if you look on that (http://www.codinghorror.com/blog/2007/12/shuffling.html) post of Jeff Atwood, that’s pretty standard way for most programmers to run shuffle. Look on the comments!

• Dan Puzey

Your assertion regarding sorting by random numbers is only true if the expression “x => rnd.Next()” is re-evaluated every time the object were accessed. If the first step of the sort were to cache the evaluated value for each member of the list, there is no issue, and it makes no difference which sorting algorithm is used.

Considering the complexity that could be present in the expression passed to OrderBy, it would seem ridiculous to re-evaluate the expression for every comparison in the sort – partly for performance and partly because you can’t guarantee consistent returns, and so it would be entirely possible for the any algorithm to be non-deterministic in this circumstance.

Indeed, by tracing the call to rnd.Next, you can prove that it *is* only called once for each element in your source array. (That said, I concede that this is an implementation detail that doesn’t *have* to be upheld.)

I think the confusion here is in what’s being randomised: you say “Imagine our comparer flips a coin each time it is asked to compare two items,” but this is not what OrderBy.(x => rnd.Next()) does: the comparison is unaffected; it is the values being compared that are changed.

There is a significant difference between the two: in actual fact, the answer to “Which comes first, a or b?” is always the same, but it the values of a and b are not guaranteed to remain constant each time the question is asked. I suspect the reason that you’ve not seen this fail in production is that to re-evaluate those values repeatedly would represent a massive fragility in the .NET API regardless of how the key were generated.

• Carlos Ribas

I love it. This is a key philosophy I strive to hold to. “Do what you mean, not what you can cleverly do instead to achieve the same effect.”

• Carlos Ribas

Which is a close relative of my other key philosophy: “Just write the damn code”