GFLogAlpha

Computes the logarithm to the primitive-element base for an element of a finite field.

Syntax

IppStatus ippsGFLogAlpha_8u(Ipp8u gfeA, Ipp8u* pLog, const IppsGFSpec_8u* pGF);

Parameters

gfeA	The element of the finite field whose logarithm is to be computed.
pLog	Pointer to the resulting logarithm value.
pGF	Pointer to the context of the finite field.

Description

This function is declared in the ippdi.h file. For an element of the finite field, the function computes the logarithm to the base being the primitive element of the field. The following pseudocode represents this function, provided i is the result of the operation:

i = log(gfeA), so that gfeA = gf_primitive_element ⁱ, if gfeA ≠ 0.

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 is NULL.
ippStsContextMatchErr	Indicates an error condition if the context pointed by pGF is not valid.
ippStsRangeErr	Indicates an error condition if gfeA is not a valid element of the finite field.
ippStsBadArgErr	Indicates an error condition if the gfeA is zero.