next up previous contents index
Next: SmallPrimeField Up: PthPowering Previous: PthPowering   Contents   Index


pExponentiation


\begin{usage}
pExponentiation(a, n)\\ pExponentiation!(a, n)
\end{usage}


Signature


\begin{params}
{\em a} & R & The element to exponentiate\\
{\em n} & \htmlref{\texttt{Integer}}{Integer} & The exponent\\\end{params}

\begin{retval}
Returns $a^n$. The exponent $n$\ must be nonnegative.
When using...
...s allowed
to be destroyed or reused, so a is lost after this call.
\end{retval}

\begin{remarks}
A call to pExponentiation!($a, n$) may cause a to be destroyed,...
...arily copying their
arguments and can thus create memory aliases.
\end{remarks}


Manuel Bronstein 2000-12-13