QuickHash Library API

SL_SHA384_FinalHex

void SL_HASHCALL SL_SHA384_FinalHex( void* pContext, void* pDest, int bUpper );
 

Parameters

pContext

    [in/out] Pointer to the context.

 pDest

    [out] Pointer to the text buffer that will receive the message digest.

 bUpper

    [in] Uppercase flag. If bUpper is 0, the received message digest represents a lowercase string, otherwise it represents an uppercase string.

Remarks

Call this function to retrieve the message digest from the context pointed by pContext. The digest is retrieved as a null-terminated hexadecimal string in the text buffer pointed by pDest. The size of the text buffer pointed by pDest must be at least SLC_SHA384_HEXDIGESTSIZE characters.

After the SL_SHA384_FinalHex function  is performed, the context is initialized for new calculations, as it would be called SL_SHA384_Init again.

Example 

#include <stdio.h>
#include <QuickHash.h>

#define BUFF_SIZE  1024

int main()
{
    FILE* file;
    unsigned char buff[ BUFF_SIZE ];
    unsigned char context[ SLC_SHA384_CONTEXTSIZE ];
    char digesthex[ SLC_SHA384_HEXDIGESTSIZE ]; /*0 terminated*/

    file = fopen( "c:\\test.txt", "rb" );

    if( file == NULL )
        return 1;

    /*****Initialize the context before calling Update, Final, or FinalHex****/

    SL_SHA384_Init( context );

    /*****Calculate the digest by calling Update for each block of the file***/

    while( !feof( file ) )
    {
        unsigned int nCount = fread( buff, sizeof( char ), BUFF_SIZE, file );
        SL_SHA384_Update( context, buff, nCount );
    }

    /*****Do final changes and get the digest in hex format*******************/

    SL_SHA384_FinalHex( context, digesthex, 0 );

    /*****Use the digest******************************************************/
    /*...*/

    fclose( file );

    return 0;
}

 

SHA384 API Overview   |   SHA384 API Functions   |   Useful Links   |   HashCalc

See Also    SL_SHA384_Final, SL_SHA384_Update, SL_SHA384_UpdateStr, SL_SHA384_Init

 

 

Send Feedback to SlavaSoft Inc. Tell a friend about QuickHash Library