The Shuffle command applies a random permutation to X.

The first parameter X is a data sample - given as e.g. a Vector.

An option inplace = true or inplace = false can be specified as a second argument. With inplace = true, Shuffle will change X in place if it is an Array or a Vector; with inplace = false, Shuffle will return a new (shuffled) copy of X. If X is a list, then Shuffle returns a new copy either way. The default is inplace = false.

The option inplace = true can be abbreviated to inplace.

The Shuffle command accepts non-numeric data.

$\mathrm{with}\left(\mathrm{Statistics}\right)\:$

$A≔\mathrm{Array}\left(\left[a\,b\,c\,d\,e\,f\,g\,h\,i\,j\right]\right)$

$A≔\left[\begin{array}{cccccccccc}a& b& c& d& e& f& g& h& i& j\end{array}\right]$

$\mathrm{A1}≔\mathrm{Shuffle}\left(A\right)$

$\mathrm{A1}≔\left[\begin{array}{cccccccccc}g& d& e& a& i& f& b& h& j& c\end{array}\right]$

$\mathrm{A2}≔\mathrm{Shuffle}\left(A\right)$

$\mathrm{A2}≔\left[\begin{array}{cccccccccc}c& e& j& g& a& f& b& h& i& d\end{array}\right]$

$\mathrm{A3}≔\mathrm{Shuffle}\left(A\right)$

$\mathrm{A3}≔\left[\begin{array}{cccccccccc}c& d& i& b& h& e& f& j& g& a\end{array}\right]$

$\mathrm{sort}\left(\mathrm{A1}\right)$

$\left[\begin{array}{cccccccccc}a& b& c& d& e& f& g& h& i& j\end{array}\right]$

$B≔\mathrm{Array}\left(\left[\mathrm{seq}\left(i\,i=1..10\right)\right]\right)$

$B≔\left[\begin{array}{cccccccccc}1& 2& 3& 4& 5& 6& 7& 8& 9& 10\end{array}\right]$

$C≔\mathrm{Shuffle}\left(B\right)$

$C≔\left[\begin{array}{cccccccccc}10& 3& 5& 1& 2& 6& 9& 4& 8& 7\end{array}\right]$

$\mathrm{OrderByRank}\left(A\,C\right)$

$\left[\begin{array}{cccccccccc}d& e& b& h& c& f& j& i& g& a\end{array}\right]$

$A$

$\left[\begin{array}{cccccccccc}a& b& c& d& e& f& g& h& i& j\end{array}\right]$

$\mathrm{Shuffle}\left(A\,\mathrm{inplace}\right)\:$$A$

$\left[\begin{array}{cccccccccc}e& d& h& i& b& j& g& c& f& a\end{array}\right]$

$\mathrm{restart}$

$\mathrm{with}\left(\mathrm{Statistics}\right)\:$

$A≔\mathrm{Array}\left(\left[a\,b\,c\,d\,e\,f\,g\,h\,i\,j\right]\right)$

$A≔\left[\begin{array}{cccccccccc}a& b& c& d& e& f& g& h& i& j\end{array}\right]$

$\mathrm{A1}≔\mathrm{Shuffle}\left(A\right)$

$\mathrm{A1}≔\left[\begin{array}{cccccccccc}g& d& e& a& i& f& b& h& j& c\end{array}\right]$

$\mathrm{restart}$

$\mathrm{with}\left(\mathrm{Statistics}\right)\:$

$A≔\mathrm{Array}\left(\left[a\,b\,c\,d\,e\,f\,g\,h\,i\,j\right]\right)$

$A≔\left[\begin{array}{cccccccccc}a& b& c& d& e& f& g& h& i& j\end{array}\right]$

$\mathrm{randomize}\left(\right)$

$47294191414$

$\mathrm{A1}≔\mathrm{Shuffle}\left(A\right)$

$\mathrm{A1}≔\left[\begin{array}{cccccccccc}f& c& h& j& g& d& i& b& e& a\end{array}\right]$