Developer Guide and Reference for Intel® Cryptography Primitives Library
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-B51D5DB3-2084-4CBD-A99F-2634762BFF32
Visible to Intel only — GUID: GUID-B51D5DB3-2084-4CBD-A99F-2634762BFF32
Add_BN
Adds two integer big numbers.
Syntax
IppStatus ippsAdd_BN(IppsBigNumState *pA, IppsBigNumState *pB, IppsBigNumState * pR);
Include Files
ippcp.h
Parameters
pA |
Pointer to the first integer big number of the data type IppsBigNumState. |
pB |
Pointer to the second integer big number of the data type IppsBigNumState. |
pR |
Pointer to the addition result. |
Description
The function adds two integer big numbers regardless of their signs and sizes and returns the result of the operation.
The following pseudocode represents this function:
(\*\ ``pR) ← (*pA) + (*pB)``
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. |
ippStsOutOfRangeErr |
Indicates an error condition if the size of pR is smaller than the resulting data length. |
ippStsContextMatchErr |
Indicates an error condition if any of the context parameters does not match the operation. |
Example
The code example below adds big numbers.
void Add_BN_sample(void){ // define and set up Big Number A const Ipp32u bnuA[] = {0x01234567,0x9abcdeff,0x11223344}; IppsBigNumState* bnA = New_BN(sizeof(bnuA)/sizeof(Ipp32u)); // define and set up Big Number B const Ipp32u bnuB[] = {0x76543210,0xfedcabee,0x44332211}; IppsBigNumState* bnB = New_BN(sizeof(bnuB)/sizeof(Ipp32u), bnuB); // define Big Number R int sizeR = max(sizeof(bnuA), sizeof(bnuB)); IppsBigNumState* bnR = New_BN(1+sizeR/sizeof(Ipp32u)); // R = A+B ippsAdd_BN(bnA, bnB, bnR); // type R Type_BN("R=A+B:\n", bnR); delete [] (Ipp8u*)bnA; delete [] (Ipp8u*)bnB; delete [] (Ipp8u*)bnR; }