ExtGet_BN
ExtGet_BN
Extracts the specified combination of the sign, data length, and value characteristics of the integer big number from the input structure.
Syntax
IppStatus ippsExtGet_BN(IppsBigNumSGN*
pSgn
, int*
pBitSize
, Ipp32u*
pData
, const IppsBigNumState*
pBN
);
Include Files
ippcp.h
Parameters
- pSgn
- Pointer to the sign ofIppsBigNumStatepBN.
- pBitSize
- Pointer to the length ofpDatain bits.
- pData
- Pointer to the data array.
- pBN
- Pointer to the integer big number contextIppsBigNumState.
Description
For the integer big number from the input structure, the function extracts the specified combination of the following characteristics: sign, data length, and value. The function is similar to the
Get_BN
function but more flexible, because any target pointer (pSgn
, pBitSize
, and/or pData
) may be NULL
, in which case the appropriate big number characteristic will not be extracted. For example,ippsExtGet_BN(&sgn, 0,0, pBN);
extracts only the signippsExtGet_BN(0, &dataLen, 0, pBN);
extracts only the data lengthippsExtGet_BN(&sgn, &dataLen, 0, pBN);
extracts the sign and data lengthippsExtGet_BN(0,0,0, pBN);
does nothingippsExtGet_BN(&sgn, &dataLen, pData, pBN);
does exactly what Get_BN
does.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or warning.
- ippStsNullPtrErr
- Indicates an error condition if the pointer to the integer big number of the context isNULL.
- ippStsContextMatchErr
- Indicates an error condition if the context parameter does not match the operation.