max@0: // Copyright (C) 2009-2010 NICTA (www.nicta.com.au)
max@0: // Copyright (C) 2009-2010 Conrad Sanderson
max@0: // Copyright (C) 2009-2010 Dimitrios Bouzas
max@0: // 
max@0: // This file is part of the Armadillo C++ library.
max@0: // It is provided without any warranty of fitness
max@0: // for any purpose. You can redistribute this file
max@0: // and/or modify it under the terms of the GNU
max@0: // Lesser General Public License (LGPL) as published
max@0: // by the Free Software Foundation, either version 3
max@0: // of the License or (at your option) any later version.
max@0: // (see http://www.opensource.org/licenses for more info)
max@0: 
max@0: 
max@0: 
max@0: //! \addtogroup fn_shuffle
max@0: //! @{
max@0: 
max@0: //! \brief
max@0: //! Shuffle the rows or the columns of a matrix or vector in random fashion.
max@0: //! If dim = 0, shuffle the columns (default operation).
max@0: //! If dim = 1, shuffle the rows.
max@0: 
max@0: template<typename T1>
max@0: inline
max@0: const Op<T1, op_shuffle>
max@0: shuffle(const Base<typename T1::elem_type,T1>& X, const uword dim = 0)
max@0:   {
max@0:   arma_extra_debug_sigprint();
max@0:   
max@0:   arma_debug_check( (dim > 1), "shuffle(): dim must be 0 or 1");
max@0:   
max@0:   return Op<T1, op_shuffle>(X.get_ref(), dim, 0);
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: //! @}