% $Date: 2003/09/15 16:37:45 $ $Author: nthiery $ $Revision: 1.1.1.1 $

\begin{Mhelppage}{Perm2Cycle}%
  {V. Prosper}%
  \begin{MInfo}
    \eng{decomposes a permutation into disjoint cycles}
  \end{MInfo}
  

\begin{MCalls}
  \Mcall{perm}
\end{MCalls}

\begin{MParameters}
  \param{perm}
  \eng{any list denoting a permutation} 
\end{MParameters}

\begin{MIntro}
  \eng{
The {\Mthis} function calculates the decomposition  of  a  permutation
into disjoint cycles. It  does  not  print the  fixed  points (cycles of
length 1).
}
\end{MIntro}

\begin{MExample}{ex1}
\begin{Mexin}
muEC::SG::Perm2Cycle( [5,4,3,2,1] );
\end{Mexin}
\begin{Mexout}
                       [[1, 5], [2, 4]]
\end{Mexout}
\end{MExample}

\MRelatedFunctions{Cycle2Perm,Perm2CycleType,Vect2Perm}
\end{Mhelppage}
