GFpSetElement

GFpSetElement#

Assigns a value to an element of the finite field.

Syntax#

IppStatus ippsGFpSetElement(const Ipp32u* pA, int lenA, IppsGFpElement* pR, IppsGFpState* pGFp);

Include Files#

ippcp.h

Parameters#

pA

Pointer to the data array storing the finite field element.

lenA

Length of the element.

pR

Pointer to the context of the finite field element being assigned.

pGFp

Pointer to the context of the finite field.

Description#

This function copies (and converts if needed) the value from the user-defined pA buffer to the IppsGFpElement context of the finite field element. If pR is NULL, GFpSetElement assigns zero to the element.

Return Values#

ippStsNoErr

Indicates no error. Any other value indicates an error or warning.

ippStsNullPtrErr

Indicates an error condition in the following cases:

  • Either pR or pGFp is NULL.

  • The length of the element lenA is greater than zero and the pointer pA is NULL.

ippStsContextMatchErr

Indicates an error condition if any of the pGFp andpR context parameters does not match the operation.

ippStsSizeErr

Indicates an error condition in the following cases:

  • lenA is not equal to the length of an element of the finite field.

  • The maximum length of the element stored in the context pR exceeds the maximum length of an element of the finite field specified by the context pGFp.

ippStsOutOfRangeErr

Indicates an error condition if the value contained in pA exceeds the modulus q of the basic prime finite field.
Contents