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

\begin{Mhelppage}{SgTranspo}{V. Prosper}%
  \begin{MInfo}
    \eng{returns a transposition}
  \end{MInfo}
  
  \begin{MCalls}
    \Mcall{i\Mopt{,j}\Mopt{,n}}
  \end{MCalls}

  \begin{MParameters}
    \param{n}
    \eng{degree of a symmetric group (positive integer)}
    \param{i}
    \eng{any positive integer}
    \param{j}
    \eng{any positive integer} 
  \end{MParameters}

  \begin{MIntro}
    \eng{The {\Mthis} function returns a transposition, that is a
      permutation interchanging two values and fixing all others.
 
      \begin{itemize}
        \item
        {\Mex{\Mthis(i)=[1, ..., i+1, i]}}.
        \item
        {\Mex{\Mthis(i,n)   =[1, ..., i+1, i, ..., n]}}.
        \item
        {\Mex{\Mthis(i,j,n) =[1, ..., j, ..., i, ..., n]}}.
      \end{itemize}
      }
  \end{MIntro}

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

\MRelatedFunctions{}
\end{Mhelppage}
