Developer Reference

Contents

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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804