Simple, generalized shuffle function

A very simple yet very general shuffle that works in a manner similar to other Matlab built-ins.

%SHUFFLE Shuffles elements.
% For vectors, SHUFFLE(X) shuffles the elements of X.
% For matrices, SHUFFLE(X) shuffles the rows of X.
% For N-D arrays, SHUFFLE(X) shuffles along the first non-singleton
% dimension of X.
%
% SHUFFLE(X,DIM) shuffles along the dimension DIM. If DIM is 0,
% then all elements of X are shuffled linearly (independently of
% any dimension).
%
% [Y,I] = SHUFFLE(X,DIM) also returns an index vector I.
% If X is a vector, then Y = X(I).
% If X is a matrix and DIM=1, then Y = X(I,:).
%
% Examples:
% X = [1 2 3; 4 5 6; 7 8 9]
% X =
% 1 2 3
% 4 5 6
% 7 8 9
%
% [Y,I] = shuffle(X)
% Y =
% 7 8 9
% 4 5 6
% 1 2 3
% I =
% 3 2 1
%
% [Y,I] = shuffle(X,2)
% Y =
% 1 3 2
% 4 6 5
% 7 9 8
% I =
% 1 3 2
% Created: Ankur Jain ([e-mail]) - 01/30/2010