GFpSetElementRandom#

Assigns a random value to an element of the finite field.

Syntax#

IppStatus1 ippsGFpSetElementRandom(IppsGFpElement* pR, IppsGFpState* pGFp, IppBitSupplier rndFunc, void* pRndParam);

Include Files#

ippcp.h

Parameters#

pR

Pointer to the context of the finite field element.

pGFp

Pointer to the context of the finite field.

rndFunc

Pseudorandom number generator.

pRndParam

Pointer to the context of the pseudorandom number generator.

Description#

This function assigns a random value 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 if any of the pointers pR, pGFp and rndFunc is NULL.

ippStsContextMatchErr

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

ippStsErr

Indicates an error condition in the following cases:

  • A call to the rndFunc() function returns a status value other than ippStsNoErr.

  • 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 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.