GFpSetElementOctString

GFpSetElementOctString#

Assigns a value from the input octet string to an element of the finite field.

Syntax#

IppStatus ippsGFpSetElementOctString(const Ipp8u* pStr, int strSize, IppsGFpElement* pR, IppsGFpState* pGFp);

Include Files#

ippcp.h

Parameters#

pStr

Pointer to the octet string.

strSize

Size of the octet string buffer in bytes.

pR

Pointer to the context of the finite field element.

pGFp

Pointer to the context of the finite field.

Description#

This function assigns a value from the input octet string to an element of the finite field.

Return Values#

ippStsNoErr

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

ippStsNullPtrErr

Indicates an error condition in any of the following cases:

  • Either pR or pGFp is NULL.

  • The length of the string is greater than zero and the pointer pStr is NULL.

ippStsContextMatchErr

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

ippStsSizeErr

Indicates an error condition in any of the following cases:

  • strSize exceeds the length of an element of the finite field.

  • strSize ≤ 0.

  • 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 in any of the following cases:

  • The length of the element stored in the context pR is not equal to the length of an element of the finite field specified by the context pGFp.

  • The value defined by pStr exceeds the modulus q of the basic prime finite field.
Contents