GFpSqrt
GFpSqrt
Computes the square root of an element of the finite field.
Syntax
IppStatus ippsGFpSqrt(const IppsGFpElement*
pA
, IppsGFpElement*
pR
, IppsGFpState*
pGFp
);
Include Files
ippcp.h
Parameters
- pA
- Pointer to the context of the finite field element.
- pR
- Pointer to the context of the resulting element of the finite field.
- pGFp
- Pointer to the context of the finite field.
Description
This function computes the square root of a given element of the GF(
p
) field. The following pseudocode represents this operation: R ⋅ R = A
. The finite field is specified by the pGFp
context.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or warning.
- ippStsNullPtrErr
- Indicates an error condition if any of the specified pointers isNULL.
- ippStsContextMatchErr
- Indicates an error condition if any of theIppsGFpStateandIppsGFpElementcontext parameters does not match the operation.
- ippStsOutOfRangeErr
- Indicates an error condition ifpAdoes not belong to the finite field specified by the contextpGFp.
- ippStsBadArgErr
- Indicates an error condition the finite field specified by the contextpGFpis not prime.
- ippStsQuadraticNonResidueErr
- Indicates an error condition ifpAis a square non-residue element.